如何解决SwiftData中「Board类型不符合PersistentModel协议」报错？

你遇到的编译错误核心原因是Board类中的自定义类型未被SwiftData识别为可持久化模型，同时部分数据类型不符合SwiftData的持久化要求，具体问题和修复方案如下：

问题根源 #

SwiftData的@Model修饰要求类中所有属性的类型必须满足以下条件之一：

• 系统基础类型（如Int、CGFloat、String、UUID等）
• 被@Model标记的自定义类
• SwiftData支持的集合类型（但对多维数组、自定义键的字典支持有限）

你的Board类中使用了Space、Character、Team、GamePhase、Action、TurnPhase、Turn这些自定义类型，其中：

1. 自定义类（Space、Character、Team、Action）未添加@Model修饰，无法被SwiftData识别为持久化模型
2. 枚举类型（GamePhase、TurnPhase、Turn）需要明确遵循Codable并确保SwiftData可以处理，建议优先使用原始值枚举
3. [[Space]]这种多维数组、[Space: Character]这种以自定义类为键的字典，目前SwiftData测试版对这类复杂集合的支持不完善

修复步骤 #

1. 为所有自定义类添加@Model修饰 #

所有需要持久化的自定义类都必须标记@Model，示例：

import SwiftData

@Model
class Space {
    // 你的Space类属性定义
}

@Model
class Character {
    // 你的Character类属性定义
}

@Model
class Team {
    // 你的Team类属性定义
}

@Model
class Action {
    // 你的Action类属性定义
}

2. 处理枚举类型 #

将枚举改为原始值类型并遵循Codable，确保SwiftData可以正常解析：

enum GamePhase: String, Codable {
    case pickTeam
    // 其他枚举值
}

enum TurnPhase: String, Codable {
    // 你的枚举值定义
}

enum Turn: String, Codable {
    case mine
    // 其他枚举值
}

3. 调整不支持的集合类型 #

• 将多维数组[[Space]]改为一维数组，或者通过反向关系建模（比如给Space类添加board: Board?属性，建立Board与Space的一对多关系）
• 将[Space: Character]这种自定义键的字典替换为数组，或者在Character类中添加space: Space?属性，直接建立两者的关联关系

4. 更新ModelContainer配置 #

如果新增了其他@Model类，需要在容器声明中一并添加：

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(for: [Board.self, Space.self, Character.self, Team.self, Action.self])
    }
}

额外注意事项 #

SwiftData处于测试阶段，部分特性存在兼容性限制：

• 尽量避免使用嵌套层级过深的复杂集合类型
• 自定义类的属性优先使用基础类型或已标记@Model的类型
• 如果枚举涉及关联值，建议暂时改用基础类型存储（如String），待正式版发布后再调整

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