SwiftData+CloudKit中Comment模型关联引发同步异常的解决方法

问题场景 #

我用SwiftData结合CloudKit构建应用，模型结构如下：

class Project
{
    @Relationship(deleteRule: .cascade, inverse: \Book.project) var books : [Book]?
    
    ...
}

class Book
{
    @Relationship(deleteRule: .nullify, inverse: \Reader.books) var readers : [Reader]?
    
    var project: Project?
    var comments: [Comment]?
    
    ...
}

class Reader
{
    @Relationship(deleteRule: .cascade, inverse: \Comment.reader) var comments: [Comment]?
    
    var book: [Book]?
    
    ...
}

class Comment
{
    @Relationship(deleteRule: .nullify, inverse: \Book.comments) var book: Book?

    var reader: Reader?
    
    ...
}

其中Project和Reader为根对象（同一Reader可出现在不同Project中），因此Book的readers属性删除规则设为.nullify。目前Project、Book、Reader的多设备同步正常，但给Comment类添加book和reader关联属性后，CloudKit同步失效，移除这两个属性则恢复正常。日志报错如下：

error: CoreData+CloudKit: -NSCloudKitMirroringDelegate_requestAbortedNotInitialized:: <NSCloudKitMirroringDelegate: 0x600003278a50> - Never successfully initialized and cannot execute request '<NSCloudKitMirroringExportRequest: 0x600002e54a00>7A3F34C3-4492-4B2C-B6D9-A0D00FCEE498' due to error: Error Domain=NSCocoaErrorDomain Code=134421 "Import failed because applying the accumulated changes hit an unhandled exception." UserInfo={NSLocalizedFailureReason=Import failed because applying the accumulated changes hit an unhandled exception., NSUnderlyingException=-[__NSDictionaryM UTF8String]: unrecognized selector sent to instance 0x600000d76560}

怀疑模型设计存在缺陷，寻求解决方案。

解决方案 #

1. 补全Comment类的关联属性注解 #

当前Comment类的reader属性未使用@Relationship修饰，SwiftData要求双向关联的两端必须明确标注@Relationship并指定inverse，否则CloudKit映射关系时会出现数据结构混乱。修改后的Comment类：

class Comment
{
    @Relationship(deleteRule: .nullify, inverse: \Book.comments) var book: Book?

    @Relationship(deleteRule: .nullify, inverse: \Reader.comments) var reader: Reader?
    
    ...
}

2. 确认模型容器的CloudKit配置 #

确保初始化ModelContainer时包含所有实体，并指定正确的CloudKit容器：

let config = ModelConfiguration("AppModel", cloudKitContainer: CKContainer.default())
let container = try! ModelContainer(for: Project.self, Book.self, Reader.self, Comment.self, configurations: config)

3. 清理本地与CloudKit数据（测试阶段） #

模型变更后可能出现本地缓存与远程数据不一致的情况，可执行以下操作：

• 删除应用重新安装，清空本地SwiftData存储
• 登录CloudKit Dashboard，删除对应容器下的所有记录类型数据
• 重启应用后重新初始化模型容器

4. 统一关联删除规则 #

当前模型的删除规则存在不一致，需确保规则符合业务逻辑且CloudKit可正确解析：

• 若删除Book时需要保留Comment，将Book的comments关联删除规则设为.nullify
• 若删除Reader时需要删除其所有Comment，Reader的comments保持.cascade，同时Comment的reader关联设为.nullify，避免循环依赖

5. 排查循环引用问题 #

模型中存在Book -> Reader -> Comment -> Book的循环关联，CloudKit处理这类结构时可能出现序列化错误，需：

• 确保所有关联的inverse都正确设置，避免隐式循环引用
• 确认SwiftData的@Relationship已正确处理弱引用逻辑，无需额外手动设置

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