SwiftData中@Model关联含description字段的struct时运行错误的解决方法

方案一：自定义Codable映射，重命名内部存储属性 #

既保留JSON的description字段映射，又规避SwiftData保留字冲突，同时支持嵌套字段的查询操作。

修改Object1（Object2同理）：

struct Object1: Codable {
    // 用非保留字作为内部存储属性名
    var desc: String
    
    // 自定义Codable键映射，关联JSON的"description"
    enum CodingKeys: String, CodingKey {
        case desc = "description"
    }
    
    // 手动初始化（可选，编译器也可自动合成）
    init(desc: String) {
        self.desc = desc
    }
}

JSON解析时仍对应description字段，SwiftData存储时使用desc，彻底避免保留字冲突。

方案二：将Struct转为Transformable数据存储 #

如果不需要查询嵌套Struct内部的字段，这是最简洁的方案——把整个Struct序列化为Data存储，SwiftData不会展开其内部属性：

修改MyModel的属性定义：

@Model
final class MyModel {
    @Attribute(.unique) var id: String
    @Attribute(.transformable) var obj1: Object1
    @Attribute(.transformable) var obj2: Object2

    init(id: String, obj1: Object1, obj2: Object2) {
        self.id = id
        self.obj1 = obj1
        self.obj2 = obj2
    }
}

Object1和Object2保持原有Codable实现即可，无需修改：

struct Object1: Codable {
    var description: String
}

缺点是无法通过SwiftData查询obj1.description这类嵌套字段，仅适用于无需基于该字段做查询的场景。

方案三：SwiftData 5.0+专属：属性重命名标记 #

如果使用SwiftData 5.0及以上版本，直接给嵌套Struct的冲突字段添加@Attribute标记指定存储名称即可，无需修改Codable逻辑：

struct Object1: Codable {
    @Attribute(name: "obj1_description")
    var description: String
}

SwiftData存储时会用obj1_description作为字段名，避开保留字，同时Codable依然正常映射JSON的description字段，是最简洁的高版本解决方案。

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