多配置ModelContainer下SwiftData实体找不到崩溃问题排查

崩溃原因 #

你创建ModelContext时未指定对应实体所在的配置，系统默认会使用ModelContainer中的第一个配置（即你定义的cloudKitConfiguration），而该配置的Schema仅包含A、B、C实体，完全没有X、Y、Z，所以执行delete(model: X.self)时，系统找不到X的实体描述，直接触发崩溃。

修复步骤 #

1. 给配置添加明确名称（可选但推荐）

先给两个配置设置唯一名称，方便后续精准获取：

let cloudKitConfiguration = ModelConfiguration(
    name: "CloudKitSync",
    schema: cloudKitSchema,
    isStoredInMemoryOnly: isStoredInMemoryOnly
)
let localConfiguration = ModelConfiguration(
    name: "LocalOnly",
    schema: localSchema,
    isStoredInMemoryOnly: isStoredInMemoryOnly
)

2. 创建ModelContext时指定本地配置

在Importer的初始化方法中，创建ModelContext必须传入包含X实体的本地配置，而非默认配置：

actor Importer: ModelActor {
    
    let modelContainer: ModelContainer
    let modelExecutor: ModelExecutor
    
    init(modelContainer: ModelContainer) throws {
        self.modelContainer = modelContainer
        
        // 获取本地配置
        guard let localConfig = modelContainer.configurations.first(where: { $0.name == "LocalOnly" }) else {
            throw NSError(domain: "ImporterInit", code: -1, userInfo: [NSLocalizedDescriptionKey: "无法找到本地存储配置"])
        }
        
        // 使用本地配置创建上下文
        let context = ModelContext(modelContainer, configuration: localConfig)
        context.autosaveEnabled = false
        modelExecutor = DefaultSerialModelExecutor(modelContext: context)
    }
    
    func `import`(from data: APIExport) async throws {
        // 现在可以正常操作X实体了
        try modelContext.delete(model: X.self)
    }
}

补充说明

如果你的导入操作需要同时操作CloudKit实体和本地实体，需分别创建对应配置的ModelContext，确保每次操作实体时，使用的上下文对应的配置包含该实体。

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