开启iCloud后SwiftData无法创建ModelContainer问题求助

针对开启CloudKit后无法创建ModelContainer的问题，可按以下步骤排查修复：

1. 修正模型间的双向关系定义 #

SwiftData与CloudKit协同工作时，必须明确标记双向关系的关联，否则会导致容器加载失败。修改两个模型的关系属性：

Notebook模型修改： #

@Model
class Notebook {
    @Attribute(.unique)
    var id: String = UUID().uuidString
    var name: String = ""
    var desc: String?
    // 明确关系的反向关联和删除规则
    @Relationship(deleteRule: .cascade, inverse: \Note.notebook)
    var notes: [Note] = []

    init(id: String = UUID().uuidString, name: String, desc: String? = nil) {
        self.id = id
        self.name = name
        self.desc = desc
    }
}

Note模型修改： #

@Model
class Note {
    @Attribute(.unique)
    var id: String = UUID().uuidString
    var created: Date = Date()
    var updated: Date?
    var text: String = ""
    // 保持非可选，因为每个Note必须属于一个Notebook
    var notebook: Notebook  

    init(id: String = UUID().uuidString, created: Date = Date(), updated: Date? = nil, text: String, notebook: Notebook) {
        self.id = id
        self.created = created
        self.updated = updated
        self.text = text
        self.notebook = notebook
     }
}

关键改动：

• 用@Relationship标记Notebook的notes属性，指定反向关联为\Note.notebook，并设置删除规则（这里用.cascade表示删除Notebook时自动删除关联的Note）
• 将notes从可选数组改为默认空数组，避免CloudKit同步时的空值歧义
• 给id添加@Attribute(.unique)标记，确保CloudKit能正确识别唯一标识

2. 配置ModelContainer的CloudKit容器ID #

开启CloudKit后，ModelConfiguration必须指定对应的iCloud容器ID，不能使用默认配置：

var sharedModelContainer: ModelContainer = {
    let schema = Schema([Notebook.self, Note.self])
    // 替换成你在Xcode中配置的iCloud容器ID，格式通常为iCloud.com.你的域名.你的App名
    let cloudKitConfig = ModelConfiguration(
        schema: schema,
        cloudKitContainerIdentifier: "iCloud.com.yourdomain.yourapp"
    )

    do {
        return try ModelContainer(for: schema, configurations: [cloudKitConfig])
    } catch {
        fatalError("Could not create ModelContainer: \(error)")
    }
}()

3. 检查Xcode的iCloud配置 #

• 打开Xcode的Signing & Capabilities标签，确认已添加iCloud功能，且勾选了CloudKit选项
• 确认已正确分配iCloud容器，容器ID与代码中填写的一致
• 确保当前使用的开发者账号拥有iCloud服务权限

4. 清理缓存并重新构建 #

• 执行Product > Clean Build Folder清理构建缓存
• 删除Derived Data（可通过Xcode > Settings > Locations找到Derived Data路径，删除对应文件夹）
• 重启Xcode后重新构建项目

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