SwiftData+SwiftUI复杂模型应用报错排查：DnD角色表开发问题

问题场景 #

我是Swift新手，正在开发一款简易DnD角色表应用，简化后的角色模型如下：

@Model
final class Character {
    var name: String
    var hitDice: Dice

    init(name: String, hitDice: Dice) {
        self.name = name
        self.hitDice = hitDice
    }
}

class Dice {
    var number: Int
    var sides: Int

    init(_ number: Int, _ sides: Int) {
        self.number = number
        self.sides = sides
    }
}

构建时触发错误：No exact matches in call to instance method 'setValue'，自定义类、字典等非原始类型都会触发该错误，怀疑和CoreData/SQLite数据类型映射有关。

将Dice改为@Model类后：

@Model
final class Dice {
     // ...
}

错误消失，但触发神秘断点，断点生成的代码包含_$backingData、persistentBackingData等自动生成的SwiftData底层代码。

应用入口代码：

import SwiftUI
import SwiftData

@main
struct CharacterSheetApp: App {
    let modelContainer: ModelContainer
    
    init() {
        do {
            modelContainer = try ModelContainer(for: Character.self)
        } catch {
            fatalError("Could not initialize ModelContainer")
        }
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(modelContainer)
    }
}

错误原因 #

• 非@Model自定义类无法直接作为SwiftData属性：SwiftData仅支持直接存储原始类型（String、Int等）或标记为@Model的类，普通自定义类、字典这类类型未实现SwiftData所需的持久化协议，导致类型映射失败，触发setValue错误。
• ModelContainer未包含所有@Model类：将Dice改为@Model后，初始化ModelContainer时只传入了Character.self，未包含Dice.self，SwiftData无法正确处理关联的模型类，进而触发底层断点。

修复步骤 #

步骤1：修正ModelContainer初始化 #

初始化ModelContainer时必须包含所有用到的@Model类，修改入口代码：

init() {
    do {
        // 同时传入Character和Dice两个@Model类
        modelContainer = try ModelContainer(for: Character.self, Dice.self)
    } catch {
        fatalError("Could not initialize ModelContainer: \(error.localizedDescription)")
    }
}

步骤2：确保Dice类的完整性 #

作为@Model类，Dice需要完整的属性定义和初始化方法，示例：

@Model
final class Dice {
    var number: Int
    var sides: Int

    init(_ number: Int, _ sides: Int) {
        self.number = number
        self.sides = sides
    }
}

可选方案：使用可编码类型替代@Model（如果不需要独立持久化Dice） #

如果Dice不需要作为独立实体存储，只是Character的附属数据，可以让Dice实现Codable，并标记为@Attribute(.externalStorage)：

class Dice: Codable {
    var number: Int
    var sides: Int

    init(_ number: Int, _ sides: Int) {
        self.number = number
        self.sides = sides
    }
}

@Model
final class Character {
    var name: String
    // 使用@Attribute(.externalStorage)存储可编码类型
    @Attribute(.externalStorage) var hitDice: Dice

    init(name: String, hitDice: Dice) {
        self.name = name
        self.hitDice = hitDice
    }
}

这种方式下，Dice会被序列化为JSON存储，无需加入ModelContainer。

额外说明 #

• SwiftData自动生成代码的断点是Xcode调试特性，通常在模型配置错误时触发，修复模型容器和类定义后会自动消失。
• 避免将非原始类型、非@Model类直接作为SwiftData模型的属性，要么转为@Model实体，要么实现Codable并使用外部存储属性。

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