SwiftData已有存储数据时修改模型致崩溃，求安全修改方案

当你修改已有数据的SwiftData模型后崩溃，核心原因是旧数据的模型结构和新模型不匹配，SwiftData默认会严格校验模型一致性，不兼容就会触发崩溃。以下是几种安全修改模型的方法：

1. 给新增属性设置默认值（最简单的日常开发方案） #

对于新增属性，直接给它设置默认值或者声明为可选类型，让SwiftData能自动给旧数据填充对应值，无需额外配置：

方案A：设置默认值 #

@Model
final class TileView {
    @Attribute (.unique) var tileName: String
    var tileLength: Double
    var tileWidth: Double
    var tilePatternName: String
    var tileType: String = "default" // 新增属性带默认值

    init(tileName: String, tileLength: Double, tileWidth: Double, tilePatternName: String, tileType: String = "default") {
        self.tileName = tileName
        self.tileLength = tileLength
        self.tileWidth = tileWidth
        self.tilePatternName = tilePatternName
        self.tileType = tileType
    }
}

方案B：声明为可选类型 #

如果属性允许为空，直接用可选类型，旧数据中该属性会被自动设为nil：

@Model
final class TileView {
    // ... 原有属性
    var tileType: String? // 新增可选属性
}

2. 启用自动迁移（处理复杂属性修改） #

如果你的修改涉及属性重命名、类型变更等更复杂的场景，需要在初始化SwiftData容器时开启自动迁移：

// 在App入口或容器初始化的地方添加配置
let container = try ModelContainer(
    for: TileView.self,
    migrationOptions: .init(
        allowsAutoMigration: true,
        customMigrationPlan: nil // 无需自定义迁移时设为nil
    )
)

这个配置会让SwiftData自动识别模型版本差异，尝试适配旧数据结构。

3. 手动管理模型版本（生产环境复杂变更） #

对于生产环境的重大模型迭代，建议手动创建模型版本和迁移计划，避免自动迁移的不确定性：

步骤1：创建旧版本模型 #

复制原模型，标记为旧版本（比如TileViewV1）：

@Model
final class TileViewV1 {
    @Attribute(.unique) var tileName: String
    var tileLength: Double
    var tileWidth: Double
    var tilePatternName: String

    init(tileName: String, tileLength: Double, tileWidth: Double, tilePatternName: String) {
        self.tileName = tileName
        self.tileLength = tileLength
        self.tileWidth = tileWidth
        self.tilePatternName = tilePatternName
    }
}

步骤2：定义新版本模型 #

保留原模型名（或使用新名），添加新属性：

@Model
final class TileView {
    @Attribute(.unique) var tileName: String
    var tileLength: Double
    var tileWidth: Double
    var tilePatternName: String
    var tileType: String

    init(tileName: String, tileLength: Double, tileWidth: Double, tilePatternName: String, tileType: String = "default") {
        self.tileName = tileName
        self.tileLength = tileLength
        self.tileWidth = tileWidth
        self.tilePatternName = tilePatternName
        self.tileType = tileType
    }
}

步骤3：创建迁移计划 #

定义从旧版本到新版本的迁移规则：

// 定义版本化Schema
struct TileSchemaV1: VersionedSchema {
    static var versionIdentifier = SchemaIdentifier("V1")
    static var models: [any PersistentModel.Type] {
        [TileViewV1.self]
    }
}

struct TileSchemaV2: VersionedSchema {
    static var versionIdentifier = SchemaIdentifier("V2")
    static var models: [any PersistentModel.Type] {
        [TileView.self]
    }
}

// 迁移计划
struct TileMigrationPlan: SchemaMigrationPlan {
    static var schemas: [any VersionedSchema.Type] {
        [TileSchemaV1.self, TileSchemaV2.self]
    }

    static var stages: [MigrationStage] {
        // 轻量级迁移，适用于属性增减、默认值设置等场景
        [MigrationStage.lightweight(fromVersion: TileSchemaV1.self, toVersion: TileSchemaV2.self)]
    }
}

步骤4：初始化容器时指定迁移计划 #

let container = try ModelContainer(
    for: TileView.self,
    migrationPlan: TileMigrationPlan.self
)

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