2026 Swift 6.2 SwiftData:並發資料層怎麼分步改造?

畫面開始卡頓、背景匯入停住,但把整個專案加上 @MainActor 後才「剛好編譯通過」——這是 SwiftData 舊專案常見的失敗改造起點。
最快的解法不是全域消警,而是先固定工具鏈與重現基線,再把一條高風險寫入鏈路收口到 @ModelActor,以 PersistentIdentifier 或 Sendable DTO 跨越隔離邊界,驗證後才逐批擴大。 這就是 Swift 6.2 SwiftData 並發重構 在不能停更的專案中較穩妥的順序。
這篇適合仍以 Swift 6.2 分支交付應用、不能一次重寫持久化層的開發者。
也適合負責拆分 SwiftData 所有權、控制回歸範圍的架構師,以及需要準備獨立 Mac 環境並行驗證多個分支的技術負責人。
工具鏈基線:先修正版本,再保存失敗案例
先釐清名稱。官方版本資料顯示,Xcode 26 初始版本包含 Swift 6.2;Xcode 26.6 已包含 Swift 6.3。因此本文處理的是仍鎖定 Swift 6.2 的維護分支,不把它描述成目前最新版。Apple 的 Xcode 版本說明也沒有「Xcode 18」這條官方版本序列,Swift 6 語言模式同樣是由專案的 target 選擇,不是所有舊專案都被強制開啟。Apple Xcode 26 版本說明
動手前先在舊分支留下四項資料:
- 每個 target 的 Swift 語言模式。
- Strict Concurrency Checking 設定與預設 Actor 隔離。
- 可重複觸發的最小測試:例如連續匯入、取消匯入後再次寫入。
- 編譯診斷、執行緒採樣、呼叫堆疊與舊分支提交點。
這一步的完成證據不是「現在比較順」,而是相同測試能再次產生相同診斷或相同停滯位置。回滾點則是保留未改動的資料層提交,以及可切換回舊寫入入口的設定。
Swift 6.2 的預設隔離、nonisolated 行為與語言模式選擇,應以 Swift Evolution 的正式提案對照,而不是把編譯器提示當成執行時結論。預設 Actor 隔離提案 非同步函式隔離提案
第一小時:沿一條資料路徑畫出所有權
不要先掃整個專案。選一條最容易出問題的新增、更新或批量匯入鏈路,從 UI 觸發點一路畫到保存完成。
需要標記的不是類別數量,而是所有權:
ModelContainer由哪個組件建立與持有。ModelContext在哪個隔離域內建立。@Model實例由哪個 context 取得。- UI 狀態、背景任務與取消訊號分別由誰管理。
- 哪些閉包正在捕獲模型實例、context 或未標示
Sendable的服務。
SwiftData 資料層應從哪條呼叫鏈開始改造?
先選寫入頻率高、失敗影響大,而且能用固定資料集重現的鏈路。不要從最容易改的讀取畫面開始,因為讀取成功不代表跨 Actor 寫入安全。
此時要把四種現象分開:
- 編譯診斷:
@Sendable、隔離衝突或 actor-isolated 成員錯誤。 - 執行時隔離失敗:模型在不屬於它的隔離域被使用。
- 主執行緒阻塞:同步工作、過大的 fetch 或保存壓住 UI。
- 真正的循環等待:必須有執行緒採樣或呼叫堆疊證據,不能只因畫面假死就稱為資料庫死鎖。
ModelActor 能提供模型屬性的互斥存取,但不能證明每次界面卡頓都是 SwiftData 內部鎖競爭。這個區分會直接決定後續是改 Actor 邊界,還是先移走主執行緒上的重工作。
首個提交:把寫入收口到單一 ModelActor
第一個提交只做一件事:替選定的寫入鏈路建立職責單一的 @ModelActor。查詢、修改與保存都在該 Actor 的 ModelContext 內完成。呼叫方只傳遞必要值,不把另一個 context 管理的模型物件直接送進去。
@ModelActor
actor ImportStore {
func add(title: String) throws -> PersistentIdentifier {
let record = ImportRecord(title: title)
modelContext.insert(record)
try modelContext.save()
return record.persistentModelID
}
}
建立服務時,使用依賴注入傳入相同持久化容器,而不是在 Actor 內偷偷建立第二個容器:
let store = ImportStore(modelContainer: container)
let identifier = try await store.add(title: title)
這段範例不是適用所有架構的萬能模板。它的邊界只有三個:寫入在 Actor 內完成、輸入是值、輸出不是跨 context 的模型物件。ModelActor 的公開語義應對照 Apple 文件;ModelContext 的生命週期與操作限制也要一併核實。Apple ModelActor 文件 Apple ModelContext 文件
完成證據包括:最小工程能重新編譯、保存錯誤可被呼叫方接收、取消時沒有遺留脫離生命週期的 Task。如果任何一項不成立,回退這個提交,不要在邊界外再加 @MainActor。
同日接入:用值取代跨 Actor 模型
@ModelActor 應返回模型物件,還是可傳送的資料?
跨 Actor 返回時,預設選 PersistentIdentifier、不可變值型別或明確符合 Sendable 的 DTO。模型物件只在取得它的 context 所屬隔離域內使用。需要在 UI 顯示時,接收方再用自己的 context 重新取得資料,而不是把背景 context 的所有權帶回主 Actor。
PersistentIdentifier 是 SwiftData 提供的識別值,不等同於已經載入的模型實例。回到 UI 層後,可依識別值重新 fetch,或由 Actor 直接回傳展示所需欄位的 DTO。Apple PersistentIdentifier 文件
struct ImportRow: Sendable {
let id: PersistentIdentifier
let title: String
let state: String
}
這樣處理後,SwiftData 後台寫入不需要把模型傳回主 Actor。錯誤、取消與保存結果也應留在結構化並發流程中傳遞。不要使用 semaphore、同步佇列回跳,或建立沒有明確生命週期的 Task 來遮住警告。
提醒:
@unchecked Sendable、@preconcurrency、Task.detached與擴大的@MainActor都只能是有範圍、有退出條件的暫時措施。它們不能同時替代資料所有權設計與死鎖證據。
分步遷移:比較可接受的改法與危險捷徑
下表用來決定每次提交的邊界,不是鼓勵一次修改所有模組:
| 改法 | 跨域輸入/輸出 | 可觀察證據 | 回滾難度 | 建議 |
|---|---|---|---|---|
單一 @ModelActor 包住一條寫入鏈路 |
值、DTO 或 PersistentIdentifier |
編譯、保存、取消測試 | 低 | 優先採用 |
全域加 @MainActor |
模型與 context 可能被主域集中持有 | 編譯可能通過,但需額外採樣 UI 阻塞 | 中 | 不作首個提交 |
@unchecked Sendable 批量標記 |
任何未驗證的引用型別 | 幾乎沒有安全證據 | 高 | 禁止作消警方案 |
Task.detached 加同步等待 |
容易切斷結構化生命週期 | 需追查遺留任務與等待鏈 | 高 | 僅在有明確隔離設計時評估 |
老專案能否只遷移一個 target 或資料模組?
可以,而且這通常更容易保留回滾路徑。前提是該 target 的 ModelContainer、模型型別與服務入口能形成清楚邊界。若共享模型仍被多個模組直接持有,先把資料存取收斂到一個模組,再逐一遷移呼叫方。
第一週按照呼叫鏈逐條推進。每次提交只改一個可觀察邊界,並保留舊實作的切換入口。逐項審計 @unchecked Sendable、@preconcurrency、Task.detached 與擴大化 @MainActor:
- 能刪除的,隨新鏈路通過後刪除。
- 必須保留的,記錄適用模組、風險與退出條件。
- 尚未適配的第三方依賴,只在模組邊緣建立兼容層。
- 業務模型不可因兼容層而被全域標成不受檢查。
並發重構期間怎樣保留舊實作作為回滾路徑?
讓新舊服務共用同一個輸入契約,在組合根或功能旗標處切換。不要讓 UI 同時知道兩種 context 的生命週期。當新鏈路通過固定資料集與錯誤測試後,再移除舊入口;在此之前,舊提交、切換開關與最小重現測試都要保留。
發布前驗證:從單機現象升級為證據
第一條鏈路完成後,才考慮複製方法到其餘模組。發布前至少覆蓋:
- 連續寫入與保存失敗。
- 任務取消後再次啟動。
- 前景、背景切換。
- 多視窗或擴充功能同時存取。
- 固定資料集上的資料一致性。
- 編譯診斷、崩潰記錄與掛起時的執行緒採樣。
同一測試工程要在目前交付工具鏈與計畫升級工具鏈分別驗證。若只在一台開發機上成功,還不能排除 DerivedData、模擬器狀態或本機快取造成的假象。需要多分支並行時,可先閱讀 ProxyMac 的環境使用說明,確認獨立 Mac 工作環境的登入、連線與檔案處理方式;完成第一條鏈路後,再依 ProxyMac 的方案頁 評估是否需要臨時驗證環境。
這裡的通過條件不是「警告變少」。至少要能回答:
- 哪些編譯診斷已由契約改動消除?
- 哪些主執行緒工作已移出,且有採樣證據?
- 哪些停滯曾被誤稱為死鎖,現在已有呼叫堆疊或已排除?
- 取消、保存失敗與重新取得模型時,資料是否仍一致?
- 新鏈路失敗時,是否能在不改資料格式的情況下切回舊實作?
完成這些證據後,才適合擴大 Swift 6.2 SwiftData 並發重構範圍。若目前方案仍依賴單台本機,常見缺點是工具鏈切換受快取影響、不同分支難以同時驗證,以及團隊成員無法重現同一套環境;這些問題會讓回歸結果混入本機差異。對需要短期測試環境、獨立驗證舊分支與新分支的團隊,租用 ProxyMac 的 Mac 環境通常比反覆整理單機更合適;但若是長期固定重負載,或必須直接使用特定實體介面,自購 Mac 仍可能更合理。