SwiftData插入MyDataClass崩溃：无法在ModelContext中插入该类

报错信息 #

*** Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: 'Cannot insert 'MyDataClass' in this managed object context because it is not found in the associated managed object model.'

问题代码 #

@Model
class MyDataClass {
    var number : String
    var pageNumberInDocument : Int
    
    init(number: String, pageNumberInDocument: Int) {
        self.number = number
      self.pageNumberInDocument = pageNumberInDocument
    }
}


@main
struct MyApp: App {
var body: some Scene {
        WindowGroup {
      ContentView()
     }.modelContainer(for:[MyDataClass.self])
 }
}

struct SaveMyData {
    @Environment(\.modelContext) var context
    
     func saveData(number: String, pageNumberInDocument : Int) {
    let dataToSave = MyDataClass(number: number, pageNumberInDocument: Int(pageNumberInDocument)!)
    
    context.insert(dataToSave)
    }
}

问题原因 #

崩溃的核心原因是：直接调用自定义init创建的MyDataClass实例，没有和当前的ModelContext绑定，也未被正确注册到关联的数据模型中。SwiftData要求@Model标记的类实例必须通过ModelContext关联的方式创建，才能被上下文识别并插入。

解决方案 #

1. 修改MyDataClass的初始化逻辑 #

为@Model类添加带ModelContext参数的初始化器，确保实例创建时就和上下文绑定：

@Model
class MyDataClass {
    var number: String
    var pageNumberInDocument: Int
    
    // 带ModelContext的初始化器，自动关联上下文
    init(context: ModelContext, number: String, pageNumberInDocument: Int) {
        self.number = number
        self.pageNumberInDocument = pageNumberInDocument
        super.init(context: context)
    }
    
    // 保留原有初始化器（可选，用于非SwiftData场景）
    init(number: String, pageNumberInDocument: Int) {
        self.number = number
        self.pageNumberInDocument = pageNumberInDocument
        super.init()
    }
}

2. 调整saveData方法的实例创建方式 #

使用带上下文的初始化器创建实例，此时实例会自动加入上下文，无需手动调用insert：

struct SaveMyData {
    @Environment(\.modelContext) var context
    
    func saveData(number: String, pageNumberInDocument: Int) {
        // 通过上下文初始化实例，自动绑定模型
        _ = MyDataClass(context: context, number: number, pageNumberInDocument: pageNumberInDocument)
        // 不需要手动调用context.insert()
    }
}

3. 额外排查步骤 #

如果修改代码后仍报错，尝试以下操作确保模型正确加载：

• 清理Xcode缓存（快捷键Cmd+Shift+K）
• 删除模拟器/真机上的App，重新编译安装

总结 #

SwiftData对@Model类的实例生命周期有严格管理，必须通过上下文关联的方式创建实例，才能保证实例被数据模型识别。遵循这个规则就能避免上述崩溃。

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