2026 Swift 6.2 SwiftData: Nebenläufige Datenschicht schrittweise umbauen

Eine globale Markierung mit @MainActor lässt das alte Projekt zwar kompilieren, danach reagieren Listen und Eingabefelder jedoch spürbar träge.
Die schnellste belastbare Lösung ist ein schrittweiser Umbau: Zuerst Werkzeugkette und Reproduktion festhalten, dann genau eine schreibende SwiftData-Kette in einen @ModelActor einschließen und nur PersistentIdentifier oder Sendable-DTOs über die Grenze geben. Erst nach einer überprüften Rückfallmöglichkeit werden weitere Aufrufer migriert.
Diese Anleitung richtet sich an Entwickler, die einen Swift-6.2-Zweig weiter ausliefern müssen, ohne die gesamte Persistenzschicht neu zu schreiben. Sie ist ebenso für Architekten gedacht, die Besitz- und Actor-Grenzen aufteilen, sowie für technische Verantwortliche, die alte und neue Projektstände in einer getrennten Mac-Umgebung prüfen.
Die falsche Abkürzung: kompilierbar, aber nicht mehr bedienbar
Ein typischer Ausgangspunkt sieht so aus: Ein altes SwiftData-Projekt meldet zahlreiche @Sendable- und Actor-Isolationsfehler. Als Sofortmaßnahme wird der Datenzugriff großflächig mit @MainActor versehen. Die Compilerdiagnosen verschwinden teilweise. Gleichzeitig laufen Import, Suche und Speichervorgänge auf derselben Isolation wie die Benutzeroberfläche.
Das ist kein Beweis für einen SwiftData-Datenbank-Deadlock. Eine blockierte Oberfläche kann durch teure Abfragen, lang laufende Speicherung, synchrones Warten, eine zyklische Task-Abhängigkeit oder echte gegenseitige Sperrung entstehen. Diese Fälle sehen ähnlich aus, benötigen aber unterschiedliche Korrekturen. Ohne Thread-Sampling und Aufrufstapel sollte kein Team das Wort „Deadlock“ als Diagnose verwenden.
Auch die Werkzeugkettenannahme muss vor dem ersten Commit stimmen. Nach den offiziellen Versionshinweisen enthält die anfängliche Xcode-26-Version Swift 6.2; Xcode 26.6 enthält bereits Swift 6.3. Ein Wartungszweig mit Swift 6.2 ist daher bewusst ein älterer, festgehaltener Werkzeugstand und nicht automatisch die aktuelle Version. Die Zuordnung ist in den offiziellen Xcode-26-Versionshinweisen dokumentiert.
Swift 6 wird außerdem nicht pauschal für jedes alte Projekt durch Apple aktiviert. Sprachmodus, Prüfung der Nebenläufigkeit und Standardisolierung werden auf Projekt- beziehungsweise Target-Ebene festgelegt. Die Entwicklung der Default-Actor-Isolation ist im Swift-Evolution-Vorschlag zur Steuerung der Default-Actor-Isolation beschrieben.
Achtung: Ein Projekt, das nach einer globalen
@MainActor-Markierung kompiliert, ist nicht automatisch korrekt. Die erste Abnahmemessung muss deshalb neben Compilerdiagnosen auch Bedienbarkeit, Aktivität und Datenkonsistenz enthalten.
Vor dem ersten Umbau: Werkzeugkette und Reproduktionsbasis
Vor der Architekturänderung wird ein sauberer Ausgangspunkt angelegt. Dafür reichen wenige, aber konkrete Artefakte:
- Swift-Version und Xcode-Version festhalten. Für jedes betroffene Target werden Swift-Sprachmodus, Prüfung der Nebenläufigkeit und Default-Actor-Isolation dokumentiert. Ein gemeinsames Projekt kann mehrere Einstellungen enthalten.
- Ein Minimalprojekt oder einen Minimaltest sichern. Der Test muss den Fehler ohne manuelle Zufallsfolge auslösen können. Geeignet sind ein Import, ein Update oder eine Speicherkette mit einem festen Datensatz.
- Diagnosen trennen. Compilerfehler, Verletzungen der Actor-Isolation, Hauptthread-Blockierung und ein möglicher Stillstand werden in getrennten Kategorien protokolliert.
- Logs und Aufrufstapel aufbewahren. Für eine vermutete Blockierung gehören Thread-Sampling und der relevante Stacktrace in das Ausgangsartefakt. Ein Bildschirmvideo allein reicht nicht.
- Den alten Stand markierbar lassen. Ein alter Branch oder eine klar benannte Revision muss weiterhin reproduzierbar bleiben. Sonst lässt sich später nicht entscheiden, ob eine Verbesserung aus dem Umbau oder aus einer veränderten Testumgebung stammt.
Diese Basis verhindert einen häufigen Fehler: Das Team ändert gleichzeitig Swift-Sprachmodus, Actor-Anmerkungen und Datenzugriffslogik. Danach ist nicht mehr erkennbar, welcher Eingriff die Warnung, die Blockierung oder den Datenfehler verursacht hat.
Die erste Aufrufkette entscheidet über das Risiko
Im nächsten Schritt wird nicht die gesamte Datenebene kartiert. Es genügt zunächst eine einzige Kette mit hoher Ausfallwirkung: etwa „Import starten → Datensätze transformieren → speichern → UI aktualisieren“. Genau diese Kette wird von ihrem Eintritt bis zur Rückmeldung verfolgt.
Dabei werden vier Besitzfragen schriftlich beantwortet:
- Wer erzeugt und besitzt den
ModelContainer? - Welcher
ModelContextführt Abfragen, Änderungen und Speicherung aus? - Wer hält UI-Zustand und sichtbare Modelle?
- Welcher Hintergrundtask oder welche Erweiterung startet die Arbeit?
Danach werden die Grenzübertritte markiert. Besonders kritisch sind:
- ein
@Model-Objekt, das in einen anderen Actor weitergereicht wird; - ein
ModelContext, der in einer Closure oder Task verborgen weiterlebt; - eine Closure, die implizit auf isolierte Daten zugreift;
- ein synchroner Rücksprung auf eine bereits wartende Ausführung;
- ein ungebundener
Task, dessen Lebensdauer nicht an den Aufrufer gekoppelt ist.
Die Diagnose entscheidet über den nächsten Schritt. Ein Typprüfungsfehler verlangt eine andere Änderung als ein Laufzeitproblem. Eine @Sendable-Warnung zeigt zunächst eine nicht belegte Übertragbarkeit. Sie beweist keinen Datenbankfehler. Eine langsame UI zeigt zunächst Arbeit auf einem ungünstigen Executor. Erst wenn Threads gegenseitig warten und sich kein Fortschritt ergibt, ist ein Deadlock eine begründete Arbeitshypothese.
Der erste Commit: ein kleiner @ModelActor statt einer globalen Sperre
Der erste Commit sollte nur eine schreibende Verantwortungsgrenze einführen. Ein @ModelActor erhält seine eigene Zuständigkeit für Abfrage, Änderung und Speicherung. Die Methode nimmt Werte entgegen, die sie für diese Operation benötigt. Sie erhält nicht einfach ein Modellobjekt, das ein anderer ModelContext verwaltet.
Ein vereinfachtes Muster sieht konzeptionell so aus:
@ModelActor
actor ImportStore {
func saveImport(_ input: ImportInput) throws -> [PersistentIdentifier] {
let records = input.items.map { item in
let record = StoredRecord(
externalKey: item.key,
title: item.title
)
modelContext.insert(record)
return record
}
try modelContext.save()
return records.map(\.persistentModelID)
}
}
ImportInput wäre dabei ein unveränderlicher Werttyp oder ein Sendable-konformes DTO. Die konkrete Initialisierung des Actors hängt davon ab, wie der Container im Projekt injiziert wird. Das Muster ist kein universelles Makro für jede Architektur. Entscheidend ist die geschlossene Zuständigkeit: Der Actor führt die Operation mit seinem Context aus und gibt anschließend keine fremden, kontextgebundenen Modelle an den Aufrufer weiter.
Die öffentliche Schnittstelle sollte klein bleiben. Ein Aufrufer liefert beispielsweise Text, IDs, Filterwerte oder DTOs. Der Actor entscheidet selbst, wann er den Context verwendet und wann er speichert. Dadurch wird der bisher verstreute Datenzugriff sichtbar und testbar.
Die öffentlich dokumentierte Bedeutung von ModelContext und seine Rolle beim Zugriff auf SwiftData-Modelle kann in der Apple-Dokumentation zu ModelContext geprüft werden. Für den Actor selbst ist die Dokumentation zu ModelActor die maßgebliche Referenz.
Rückgabeverträge: Modellbesitz gegen sichere Datenübergabe
Der schwierigste Teil beginnt oft nach dem ersten erfolgreichen Speichern. Die alte Methode gab ein Array von @Model-Objekten zurück, damit die UI es direkt anzeigen konnte. Genau dadurch wird der Besitz des Modells über eine Actor-Grenze gezogen.
Die neue Schnittstelle sollte eine von drei Formen verwenden:
PersistentIdentifier: Der Hintergrund-Actor gibt die Identität eines gespeicherten Objekts zurück. Der Empfänger lädt es in seinem eigenen Context neu. Die öffentliche Bedeutung vonPersistentIdentifierist in der Apple-Referenz zu PersistentIdentifier beschrieben.- Unveränderlicher Werttyp: Die UI erhält nur die Felder, die sie für die Darstellung benötigt. Änderungen an diesem Werttyp verändern nicht das gespeicherte Modell.
- Sendable-DTO: Für komplexere Ergebnisse wird ein ausdrücklich für die Übertragung geeignetes DTO definiert. Es enthält keine versteckten Context-, View- oder Actor-Referenzen.
Damit verschiebt sich die Frage von „Wie bringe ich dieses Modell zurück?“ zu „Welche Information benötigt der Empfänger wirklich?“. Für eine Liste genügen oft ID, Titel, Status und ein Datum. Die UI muss nicht die gesamte Persistenzstruktur besitzen.
Fehler und Abbruch werden ebenfalls über die Grenze geführt. Eine asynchrone Methode soll ihren Fehler zurückgeben oder werfen und auf Cancellation reagieren. Ein Semaphore, eine synchrone Dispatch-Warteschlange oder ein zusätzlich gestarteter Task ohne Lebenszyklusbindung kaschiert lediglich die Abhängigkeit. Solche Mittel können eine Warnung zum Schweigen bringen, lösen aber keine unklare Besitzbeziehung.
Erfahrung aus der Migration: Wenn ein DTO plötzlich sehr viele Felder und Methoden benötigt, ist das oft ein Hinweis auf eine zu breite UI-Abhängigkeit. Dann sollte die Schnittstelle erneut auf den tatsächlichen Anwendungsfall begrenzt werden, statt das Modellobjekt nur unter einem anderen Namen weiterzureichen.
Welche Grenze passt zu welchem Aufrufer?
Für die Entscheidung im Bestand hilft eine direkte Gegenüberstellung. Sie verhindert, dass jede Warnung mit derselben Maßnahme behandelt wird.
| Situation | Bevorzugte Änderung | Vermeiden | Nachweis vor dem nächsten Schritt |
|---|---|---|---|
| Hintergrundimport schreibt in SwiftData | Eine eigene @ModelActor-Operation mit eigenem Context |
Globales @MainActor für die gesamte Datenebene |
Import beendet, Speicherung ist reproduzierbar, UI bleibt bedienbar |
| UI benötigt ein gespeichertes Ergebnis | PersistentIdentifier oder kleines Sendable-DTO |
Rückgabe eines fremden @Model-Objekts |
UI lädt oder verarbeitet nur ihre benötigten Daten |
| Drittanbieter-Modul ist noch nicht angepasst | Kleine Kompatibilitätsschicht am Modulrand | @preconcurrency und @unchecked Sendable im Geschäftsmodell |
Die Ausnahme ist dokumentiert und außerhalb des Moduls nicht sichtbar |
| Alte Implementierung muss erhalten bleiben | Gemeinsames Protokoll mit zentraler Umschaltung | Verstreute Feature Flags in vielen Aufrufern | Ein einzelner Pfad kann auf die alte Implementierung zurückgestellt werden |
| Oberfläche reagiert nicht | Sampling, Stacktrace und Wartebeziehungen prüfen | Sofortige Bezeichnung als SwiftData-Deadlock | Eine belastbare Ursache oder ein begrenzter Fehlerverdacht liegt vor |
Diese Tabelle ist kein Ersatz für Tests. Sie begrenzt lediglich den Lösungsraum. Besonders @unchecked Sendable darf nicht als allgemeiner Reparaturschalter behandelt werden. Das Schlüsselwort verschiebt die Verantwortung vom Compiler zum Team. Wenn die behauptete Sicherheit nicht bewiesen werden kann, ist die Markierung keine Lösung.
Am selben Arbeitstag: Eingaben, Ergebnisse und Cancellation ersetzen
Nach dem ersten Actor-Commit wird die gesamte ausgewählte Kette bis zu ihrem Aufrufer angepasst. Die Übergabe wird an beiden Enden explizit gemacht:
- Der Aufrufer baut ein DTO oder einen Werttyp.
- Der
@ModelActorerzeugt oder lädt die Modelle in seinem Context. - Der Actor speichert und gibt IDs oder Ergebniswerte zurück.
- Die UI aktualisiert ihren eigenen Zustand.
- Ein Abbruch beendet die laufende Operation, statt eine zweite konkurrierende Speicherung zu starten.
Für Aktualisierungen sollte die Eingabe möglichst eine stabile externe ID oder PersistentIdentifier enthalten. Der Actor lädt das Objekt selbst. Wird ein Objekt nicht gefunden, wird dieser Fall als definierter Fehler behandelt. Die Methode sollte nicht stillschweigend einen neuen Datensatz anlegen, wenn dadurch Duplikate entstehen können.
Bei mehreren Rückgabewerten ist ein Ergebnis-DTO sinnvoll. Es kann beispielsweise eine Anzahl verarbeiteter Eingaben, betroffene IDs und fachliche Warnungen enthalten. Die Zahl selbst ist dabei kein Performanceversprechen. Sie beschreibt nur das Ergebnis dieser konkreten Operation.
Die wichtigste Grenze lautet: Der UI-Layer erhält keine Eigentümerschaft an einem Hintergrund-Context. Er erhält Daten. Das reduziert versteckte Rücksprünge und macht Tests unabhängiger von einer bestimmten Thread-Reihenfolge.
In der ersten Migrationswoche: Aufrufer einzeln umstellen
Nach der ersten funktionsfähigen Kette beginnt nicht die flächige Suche nach allen Compilerwarnungen. Die Aufrufer werden nach Schreibfrequenz, Fehlerfolgen und Abhängigkeiten geordnet migriert. Jede Änderung sollte eine beobachtbare Grenze betreffen.
Für jeden weiteren Aufrufer wird ein kurzer Nachweis abgelegt:
- Welche Eingabe überschreitet die Grenze?
- Welcher Context besitzt das Modell danach?
- Welche Rückgabeform wird verwendet?
- Welche alte Implementierung bleibt als Rückfall erhalten?
- Welche Ausnahme oder Übergangsmarkierung kann nach diesem Commit entfernt werden?
Dabei werden temporäre Maßnahmen einzeln auditiert:
@unchecked Sendable@preconcurrencyTask.detached- großflächige
@MainActor-Anmerkungen - Synchronisation über Semaphore oder synchrone Warteschlangen
Was nach der neuen Grenze nicht mehr benötigt wird, wird entfernt. Was bleiben muss, erhält eine dokumentierte Reichweite und eine konkrete Entfernungsvoraussetzung. Ein noch nicht angepasstes Fremdmodul gehört an den Rand der Anwendung. Seine Kompatibilitätsschicht darf nicht die internen Geschäftsmodelle infizieren.
Ein Protokoll mit zwei Implementierungen erleichtert den Rückweg:
protocol Importing: Sendable {
func run(_ input: ImportInput) async throws -> ImportResult
}
struct ImportService {
let implementation: any Importing
func run(_ input: ImportInput) async throws -> ImportResult {
try await implementation.run(input)
}
}
Die Auswahl zwischen alter und neuer Implementierung sollte an einer Stelle erfolgen. Dadurch bleibt ein einzelner Pfad rückrollbar, ohne dass sämtliche Aufrufer erneut geändert werden müssen.
Vor der Veröffentlichung: reale Pfade statt nur grüner Build
Die neue Grenze wird erst dann auf weitere Module übertragen, wenn die ausgewählte Kette in mehreren realistischen Abläufen stabil ist. Der feste Testdatensatz sollte mindestens folgende Fälle abdecken:
- fortlaufende Schreibvorgänge;
- Abbruch während der Verarbeitung;
- Wechsel zwischen Vorder- und Hintergrund;
- gleichzeitige Zugriffe mehrerer Fenster oder Erweiterungen;
- erneutes Laden der UI aus dem eigenen Context;
- fehlerhafte Eingaben und ein fehlgeschlagener Speichervorgang.
Neben dem Testergebnis gehören Absturzprotokolle, Hänger-Samples und Datenkonsistenz in den Nachweis. Ein Test, der nur „erfolgreich beendet“ meldet, kann einen verlorenen Schreibvorgang übersehen.
Die Prüfung erfolgt sowohl mit der aktuell ausgelieferten Swift-6.2-Werkzeugkette als auch mit der geplanten Upgrade-Umgebung. So wird sichtbar, ob ein Problem wirklich aus dem Quellcode stammt oder nur aus DerivedData, einem Simulatorzustand oder einer einzelnen Entwicklungsmaschine. Das ist besonders relevant, wenn mehrere Projektzweige parallel gewartet werden. Eine getrennte Mac-Umgebung kann dabei helfen, alte und neue Werkzeugstände unabhängig zu prüfen. Hinweise zur Anmeldung und Umgebung lassen sich in der ProxyMac-Hilfe nachlesen; bei mehreren getrennten Arbeitsständen ist auch die ProxyMac-Konsole ein naheliegender Verwaltungspunkt.
Erst wenn Kompilierung, Aktivität und Datenkonsistenz für die erste Kette belegt sind, wird das Muster kopiert. Ein erfolgreiches @ModelActor-Beispiel beweist nicht, dass jede andere Datenoperation dieselben Lebensdauern und Abhängigkeiten besitzt.
Häufige Fragen zur schrittweisen SwiftData-Migration
Mit welcher SwiftData-Aufrufkette sollte die Migration beginnen?
Nicht mit dem größten Modul und nicht mit einer zufällig ausgewählten Compilerwarnung. Geeignet ist eine einzelne schreibende Kette, deren Fehlerfolgen relevant sind und die sich mit festen Eingaben reproduzieren lässt. Import, Synchronisation oder Batch-Update sind oft aussagekräftiger als ein einfacher Lesezugriff. Vor dem ersten Commit werden Container, Context, Modelle und UI-Zustand dieser Kette dokumentiert.
Sollte ein @ModelActor ein Modellobjekt oder Sendable-Daten zurückgeben?
Über eine Actor-Grenze sind PersistentIdentifier, unveränderliche Werttypen oder ein ausdrücklich Sendable-konformes DTO die belastbarere Wahl. Ein @Model-Objekt gehört zu einem bestimmten ModelContext. Die empfangende Seite lädt das Objekt bei Bedarf mit ihrem eigenen Context neu. So wird kein fremder Modellbesitz in die UI oder einen zweiten Actor übertragen.
Wie bleibt eine SwiftData-Hintergrundschreiboperation vom Main Actor getrennt?
Der Hintergrund-Actor führt Abfrage, Änderung und Speicherung vollständig in seinem eigenen Context aus. Der Aufrufer übergibt nur Werte, IDs oder DTOs. Für die Rückgabe werden IDs oder Ergebnisdaten verwendet. Synchrone Rücksprünge, Semaphore und ungebundene Tasks sind keine sichere Abkürzung, weil sie Wartebeziehungen und Lebensdauerprobleme verdecken können.
Kann ein altes Projekt nur ein Target oder Datenmodul migrieren?
Ja. Die Grenze muss dann aber technisch sichtbar sein: ein Protokoll, eine klar benannte Implementierung und eine zentrale Umschaltung. Der übrige Bestand darf weiterhin den alten Pfad verwenden. Nach der Prüfung des ersten Moduls werden weitere Aufrufer einzeln umgestellt. Eine globale Annotation über das gesamte Projekt würde diese Rückrollbarkeit wieder schwächen.
Wie bleibt die alte Implementierung während des Umbaus rückrollbar?
Die alte und neue Variante sollten dieselbe fachliche Schnittstelle bedienen. Eine zentrale Auswahl entscheidet, welcher Pfad verwendet wird. Für jede Übergangsmarkierung werden betroffener Aufrufer, zulässige Reichweite und Entfernungsvoraussetzung notiert. Kann ein Fehler auf einen neuen Teilpfad eingegrenzt werden, wird nur dieser Pfad zurückgeschaltet.
Die passende Umgebung für den nächsten Rücklauf
Nach der ersten erfolgreichen @ModelActor-Kette lohnt sich eine getrennte Prüfung des alten und des neuen Zweigs. Ein lokaler Rechner ist dafür nicht immer die beste Langzeitlösung: Cache-Zustände, unterschiedliche Xcode-Installationen, begrenzte physische Ressourcen und ein gemeinsam genutzter Arbeitsstand erschweren die Ursachenanalyse. Eine lokale Mac-Konfiguration bleibt sinnvoll, wenn dauerhaft hohe Last, spezielle Geräteanschlüsse oder vollständige Kontrolle über die Hardware erforderlich sind.
Für zeitlich begrenzte Regressionen ist eine gemietete Mac-Umgebung von ProxyMac oft die passendere Ergänzung. Sie trennt Testzweige vom Entwicklungsrechner, erleichtert die Wiederholung mit einer definierten Werkzeugkette und vermeidet, dass ein beschädigter Simulator- oder DerivedData-Zustand die Bewertung verfälscht. Vor der Auswahl sollten Verantwortliche dennoch prüfen, ob die benötigte Xcode-Version verfügbar ist, wie Zugänge verwaltet werden und ob die Anforderungen an Datenschutz und DSGVO erfüllt sind. Für Kontoverwaltung und Zugriffsfragen stehen die ProxyMac-Datenschutzhinweise bereit.
Die Entscheidung bleibt abhängig vom Einsatz: Für einen kurzen Swift-6.2-Rücklauf, parallele Branch-Prüfungen und reproduzierbare Testumgebungen spricht vieles für Miete. Für dauerhaftes Hochlast-Testing oder erforderliche physische Schnittstellen ist eigene Hardware oft geeigneter. Entscheidend ist, dass der nächste Test dieselbe Grenze prüft wie der erste: ein klarer @ModelActor, ein definierter Datenvertrag und ein nachweisbarer Rückweg.