使用带递归关联的SwiftData模型解析JSON时崩溃

核心问题原因 #

直接使用JSONDecoder解码@Model标记的Person类实例是错误的，原因有两点：

1. SwiftData模型的管理机制：@Model类的实例必须由ModelContext创建和管理，手动通过Codable的init(from:)创建实例会绕过SwiftData的内部追踪机制，导致关联关系（如children数组）无法被识别，触发Unknown related type - Person错误。
2. 关联关系的定义错误：SwiftData中表示一对多自关联，需要用@Relationship属性标记，而非普通的可选数组，普通数组无法被SwiftData正确处理关联的持久化逻辑。

解决方案：使用DTO（数据传输对象）分离JSON解析与SwiftData模型 #

正确的做法是创建纯结构体的DTO用于JSON解码，再将DTO数据映射为SwiftData模型实例并插入上下文。

步骤1：定义JSON解析专用的DTO

// 仅用于JSON解析的DTO，和SwiftData完全解耦
struct PersonDTO: Codable {
    let name: String
    let children: [PersonDTO]?
    
    // 将DTO转换为SwiftData的Person实例，确保每个实例都被插入上下文
    func toModel(context: ModelContext) -> Person {
        let person = Person(name: name)
        context.insert(person)
        // 递归转换子节点，保证所有子实例都在同一个上下文管理下
        person.children = children?.map { $0.toModel(context: context) }
        return person
    }
}

struct PersonAPIDTO: Codable {
    let data: [PersonDTO]
}

步骤2：修正SwiftData的Person模型

添加@Relationship标记关联关系，移除用于外部JSON解码的自定义init(from:)（如果不需要SwiftData内部的Codable持久化，也可以完全移除Codable实现）：

@Model
final class Person {
    var name: String
    // 用@Relationship标记自关联，deleteRule指定删除父节点时的子节点处理规则
    @Relationship(deleteRule: .cascade)
    var children: [Person]?
    
    init(name: String, children: [Person]? = nil) {
        self.name = name
        self.children = children
    }
}

步骤3：修改JSON解析与模型转换逻辑

// 获取已配置的ModelContext
guard let context = viewContext else { return }

do {
    // 先解码DTO
    let decodedDTO = try JSONDecoder().decode(PersonAPIDTO.self, from: data)
    // 将DTO转换为SwiftData模型并插入上下文
    let _ = decodedDTO.data.map { $0.toModel(context: context) }
    // 保存上下文，持久化数据
    try context.save()
} catch {
    print("解析或保存失败：\(error)")
}

补充说明 #

• 原代码中直接解码Person实例时，创建的对象没有被ModelContext接管，SwiftData无法识别其关联关系的元数据，因此触发致命错误。
• 即使将JSON中的null改为[]，也会因为同样的上下文缺失问题，导致关联关系无法被正确处理，引发其他错误。

内容的提问来源于stack exchange，提问作者Van Du Tran