SwiftUI中如何用Model Container初始化单例并保留环境上下文？

问题背景 #

需要在SwiftUI中实现带有Model Container的单例UserData，同时保证全应用视图能通过@Environment(\.modelContext)访问数据上下文。当前实现中MyApp和UserData各自创建了一个Model Container实例，导致CloudKit同步冲突，应用崩溃。

崩溃错误信息 #

error: CoreData+CloudKit: -[NSCloudKitMirroringDelegate resetAfterError:andKeepContainer:](611): <NSCloudKitMirroringDelegate: 0x3015d14a0> - resetting internal state after error: Error Domain=NSCocoaErrorDomain Code=134422 "CloudKit setup failed because it couldn't register a handler for the export activity. There is another instance of this persistent store actively syncing with CloudKit in this process." UserInfo={NSUnderlyingException=Illegal attempt to register a second handler for activity identifier com.apple.coredata.cloudkit.activity.export.9EBB4062-A03B-4BD3-9222-D079F7C93EBA, NSURL=file:///var/mobile/Containers/Data/Application/85683180-384B-4276-88EE-384E50401A37/Library/Application%20Support/default.store, activityIdentifier=com.apple.coredata.cloudkit.activity.export.9EBB4062-A03B-4BD3-9222-D079F7C93EBA, NSLocalizedFailureReason=CloudKit setup failed because it couldn't register a handler for the export activity. There is another instance of this persistent store actively syncing with CloudKit in this process.}

核心问题分析 #

当前代码中存在两个独立的Model Container实例：

• MyApp通过.modelContainer(for: [Observation.self])创建了一个Container
• UserData单例的私有初始化方法中又新建了另一个ModelContainer

这导致CloudKit同步时出现冲突，因为同一进程中不能有两个同步同一个CloudKit数据库的Store实例。

正确解决方案（保留单例模式） #

方案一：在App入口创建Model Container，注入到单例 #

通过全局唯一的Container实例，同时供给单例和应用环境使用：

1. 修改UserData实现

将单例的初始化改为接受外部传入的Model Container，避免内部创建新实例：

import SwiftUI
import SwiftData
import os

private actor DataStore {
    let logger = Logger(
        subsystem: "com.cyrilzakka.MyApp.DataStore",
        category: "ModelIO")
    
    private let container: ModelContainer
    
    init(container: ModelContainer) {
        self.container = container
    }
    
    func update(newObservations: [ObservationWrapper], deletedObservations: [UUID]) async throws {
        let context = ModelContext(container)
        
        let modelUpdates = newObservations.lazy.map { sample in
            // 原有转换代码保持不变
        }
        
        try context.transaction {
            for obj in modelUpdates {
                context.insert(obj)
            }
            try context.delete(model: Observation.self, where: #Predicate { sample in
                deletedObservations.contains(sample.id!)
            })
            try context.save()
            
            logger.debug("Database updated successfully with new and deleted observations.")
        }
    }
}

@MainActor
public class UserData: ObservableObject {
    let userDataLogger = Logger(
        subsystem: "com.cyrilzakka.MyApp.UserData",
        category: "Model")
    
    // 将shared改为可选类型，由App入口初始化
    public static var shared: UserData!
    
    public lazy var healthKitManager = HKManager(withModel: self)
    
    let modelContainer: ModelContainer
    private var store: DataStore
    
    // 开放接受外部Container的初始化方法
    public init(modelContainer: ModelContainer) {
        self.modelContainer = modelContainer
        self.store = DataStore(container: modelContainer)
    }
    
    func updateObservations(newObservations: [ObservationWrapper], deletedObservations: [UUID]) {
        Task {
            do {
                try await store.update(newObservations: newObservations, deletedObservations: deletedObservations)
                userDataLogger.debug("Observations updated successfully.")
            } catch {
                userDataLogger.error("Failed to update observations: \(error.localizedDescription)")
            }
        }
    }
}

2. 修改MyApp实现

在App初始化时创建全局唯一的Container，初始化单例并注入应用环境：

import SwiftData

@main
struct MyApp: App {
    let container: ModelContainer
    
    init() {
        do {
            // 根据需求配置CloudKit或其他参数
            let config = ModelConfiguration(cloudKitDatabase: .private("iCloud.com.author.MyApp"))
            container = try ModelContainer(for: Observation.self, configurations: config)
            // 初始化UserData单例
            UserData.shared = UserData(modelContainer: container)
        } catch {
            fatalError("Failed to configure SwiftData container: \(error.localizedDescription)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(UserData.shared)
        }
        .modelContainer(container) // 将Container注入环境，供视图通过@Environment(\.modelContext)访问
    }
}

方案二：在单例中创建Model Container，提供给全应用 #

如果希望UserData负责创建和管理Model Container，只需将其创建的Container注入应用环境：

1. 修改UserData实现

保持单例的私有初始化，同时保留modelContainer属性供外部使用：

@MainActor
public class UserData: ObservableObject {
    let userDataLogger = Logger(
        subsystem: "com.cyrilzakka.MyApp.UserData",
        category: "Model")
    
    public static let shared = UserData()
    
    public lazy var healthKitManager = HKManager(withModel: self)
    
    // 暴露Container属性
    let modelContainer: ModelContainer
    private var store: DataStore
    
    private init() {
        do {
            let config = ModelConfiguration(cloudKitDatabase: .private("iCloud.com.author.MyApp"))
            modelContainer = try ModelContainer(for: Observation.self, configurations: config)
            store = DataStore(container: modelContainer)
        } catch {
            fatalError("Failed to initialize ModelContainer: \(error.localizedDescription)")
        }
    }
    
    // 原有方法保持不变
    func updateObservations(newObservations: [ObservationWrapper], deletedObservations: [UUID]) {
        Task {
            do {
                try await store.update(newObservations: newObservations, deletedObservations: deletedObservations)
                userDataLogger.debug("Observations updated successfully.")
            } catch {
                userDataLogger.error("Failed to update observations: \(error.localizedDescription)")
            }
        }
    }
}

2. 修改MyApp实现

直接使用单例中的Container注入应用环境：

import SwiftData

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(UserData.shared)
        }
        .modelContainer(UserData.shared.modelContainer) // 使用单例的Container
    }
}

对尝试写法的点评 #

你尝试的写法方向正确，但需要注意：UserData的shared属性不能是let（因为需要重新赋值），必须改为var且为可选类型，否则会编译报错。调整后就是方案一的实现逻辑，能彻底解决多Container冲突问题。

内容的提问来源于stack exchange，提问作者cyril