SwiftData预览崩溃求助：父子类关联时Xcode画布崩溃

问题 #

基于SwiftData实现带关联关系的父子数据库模型，在简单视图中展示时，Xcode画布预览崩溃，但注释掉item.parent = .preview后预览恢复正常。使用的actor PreviewSampleData及相关代码源自Apple官方SwiftData示例。

根因 #

• 预览环境中，静态的.preview父对象未被正确注入当前预览专用的SwiftData内存上下文，直接赋值关联会导致上下文状态冲突。
• Actor的并发初始化逻辑可能导致父子对象分属不同上下文实例，触发SwiftData的关联校验错误。

修复方案 #

1. 统一在预览上下文内创建关联数据 #

修改预览数据生成逻辑，确保父子对象都在同一个上下文里创建并建立关联，避免跨上下文引用：

actor PreviewSampleData {
    static func makePreviewContext() -> ModelContext {
        let config = ModelConfiguration(isStoredInMemoryOnly: true)
        let container = try! ModelContainer(for: Parent.self, Child.self, configurations: config)
        let context = container.mainContext
        
        // 在当前上下文创建父对象
        let parent = Parent(name: "Preview Parent")
        context.insert(parent)
        
        // 创建子对象并关联同上下文的父实例
        let child = Child(name: "Preview Child")
        child.parent = parent
        context.insert(child)
        
        try! context.save()
        return context
    }
}

// 预览视图配置
struct YourView_Previews: PreviewProvider {
    static var previews: some View {
        YourView()
            .modelContainer(for: [Parent.self, Child.self], inMemory: true)
            .environment(\.modelContext, PreviewSampleData.makePreviewContext())
    }
}

2. 校验模型关联定义 #

确保父子模型的@Relationship反向关联配置正确：

@Model
class Parent {
    var name: String
    @Relationship(inverse: \Child.parent) var children: [Child] = []
    
    init(name: String) {
        self.name = name
    }
}

@Model
class Child {
    var name: String
    var parent: Parent?
    
    init(name: String) {
        self.name = name
    }
}

3. 移除静态预览数据的跨上下文引用 #

不要将父对象定义为静态属性直接复用，每次生成预览上下文时都创建全新的关联数据，保证所有对象归属同一上下文。

核心原理 #

Xcode预览的SwiftData上下文是独立的内存实例，所有关联的模型对象必须属于同一个上下文才能通过SwiftData的状态校验。跨上下文引用对象会触发内部一致性检查失败，导致预览崩溃。通过在上下文内部完成所有对象的创建与关联，可彻底避免这类问题。

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