在使用 SwiftData 存储数据时，随着应用的更新，常常需要调整数据结构，例如新增、删除字段或修改字段类型。如果不处理这些变更，旧数据可能导致应用崩溃。

本文将探讨 SwiftData 数据结构变更带来的问题，并提供最佳实践以确保应用的稳定性和数据一致性。

数据结构变更引发的崩溃问题

我计划在新版 MONO APP 中，为每笔账单添加一个支付渠道的功能。为了实现这个功能，我在数据结构中添加了一个新的 PaymentMethod 字段用于存储支付信息。

@Attribute() var paymentMethod: PaymentMethod = PaymentMethod.others  // 新增字段，默认值为其他

这一修改在新设备上运行良好，但是对于之前已经安装并使用过该应用的用户，却会遇到以下报错：crashed due to fatalError in ModelCoders.swift at line xxxx.

原因是我添加了一个新的 paymentMethod 字段，但旧的数据中缺少这个字段，应用在加载旧数据时无法为这个字段赋值，最终导致崩溃。这个问题通常会在数据库架构变更或者 SwiftData 模型更新时发生。

常见解决方案

通过模型初始化器添加默认值

如果你的应用数据来自远程服务器，解码数据前通常需要经过一个解码过程。对于缺失字段，可以在 Decodable协议的自定义初始化器 init(from decoder:) 中处理。比如，手动实现 Decodable 协议时，可以为缺失字段指定默认值：

// 手动实现 Decodable 协议
required init(from decoder: Decoder) throws {
    // 尝试解码 PaymentMethod，如果失败则使用默认值
    self.paymentMethod = try container.decodeIfPresent(PaymentMethod.self, forKey: .paymentMethod) ?? .others
    
    // 其余解码逻辑...
}

在这种情况下，如果 paymentMethod 字段在旧数据中不存在，系统会自动将其设置为 .others，避免因字段缺失导致崩溃。

需要注意的是，Decodable 初始化器仅在数据解码时执行，通常是从外部来源（如远程服务器的 JSON 数据）解压缩并转换为本地对象时生效。当数据已经存储在本地（如 SwiftData 数据库中），查询操作不会再次调用 Decodable 初始化器，因此缺失字段的默认值逻辑无法生效。

对于这种情况，你应该考虑在【使用计算属性（computed property）在访问时添加默认值】方案，或者主动的【数据迁移策略】。

使用计算属性（computed property）在访问时添加默认值

通过定义计算属性，可以在每次访问字段前添加自定义逻辑，确保当字段缺失时，返回指定的默认值。示例如下：