SwiftData保存含FirestoreStruct的@Model类时编码错误如何解决

问题核心在于@DocumentID是Firestore专属的属性包装器，仅能被Firestore的编码器识别处理，但SwiftData默认使用系统编码器，无法兼容该属性，导致保存时触发编码失败。以下是三种可行的解决方法：

方案1：分离Firestore专用与本地存储结构体 #

创建独立的本地存储结构体，剥离Firestore专属的@DocumentID属性，彻底避免编码冲突：

// 本地存储专用结构体
struct LocalFirestoreData: Codable {
    var id: String?
    var title: String
}

// 修改MyModel使用本地结构体
@Model
final class MyModel {
    @Attribute(.unique) var id: String
    var firestoreData: LocalFirestoreData
    
    init(id: String, firestoreData: LocalFirestoreData) {
        self.id = id
        self.firestoreData = firestoreData
    }
    
    // 新增从FirestoreStruct转换的初始化方法
    init(id: String, firestoreStruct: FirestoreStruct) {
        self.id = id
        self.firestoreData = LocalFirestoreData(id: firestoreStruct.id, title: firestoreStruct.title)
    }
}

使用时，先将Firestore返回的FirestoreStruct转换为LocalFirestoreData，再存入SwiftData即可。这种方式职责分离清晰，后续维护更方便。

方案2：给FirestoreStruct自定义编码逻辑 #

手动实现Codable的编码方法，将@DocumentID当作普通属性处理，绕过Firestore的专属编码限制：

struct FirestoreStruct: Codable {
    @DocumentID var id: String?
    var title: String
    
    enum CodingKeys: String, CodingKey {
        case id, title
    }
    
    // 自定义编码逻辑，手动处理id属性
    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(id, forKey: .id)
        try container.encode(title, forKey: .title)
    }
    
    // 解码保留默认逻辑，兼容Firestore文档ID解析
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        self.id = try container.decodeIfPresent(String.self, forKey: .id)
        self.title = try container.decode(String.self, forKey: .title)
    }
}

修改后，SwiftData的编码器可以正常处理该结构体，同时不影响Firestore的解码逻辑。

方案3：替换@DocumentID为普通属性 #

直接去掉@DocumentID属性包装器，改为普通属性，从Firestore获取数据时手动赋值文档ID：

struct FirestoreStruct: Codable {
    var id: String?
    var title: String
}

// 从Firestore获取数据时手动设置文档ID
let docSnapshot: DocumentSnapshot = ... // 获取到的文档快照
var firestoreData = try docSnapshot.data(as: FirestoreStruct.self)
firestoreData.id = docSnapshot.documentID

这种方式最直接，完全规避了Firestore专属属性带来的编码问题。

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