Firestore Codable结构体改写及数组更新报错问题求助

问题背景 #

Firestore文档结构如下：

myArray.                                       <-- Firestore (数组)
  0                                            <-- 数组元素为Firestore (映射)
    timestamp: May 30, 2023 12:00:00 PM        <-- Firestore (时间戳)
    text: "ABCD"                               <-- Firestore (字符串)

最初尝试的结构体因使用Array<[String:Any]>无法遵循Decodable协议：

struct MyStruct: Codable {
    @DocumentID var id: String?
    var myArray: Array<[String:Any]>
}

修改为具体结构体后，写入Firestore正常，但执行数组更新时出错：

struct MyStruct: Codable {
    @DocumentID var id: String?
    var myArray: Array<MyData>?
}

struct MyData: Codable {
    var name: String
    var timestamp: Date
}

// 实例化代码（存在错误）
let myData = MyData(name: "name", timestamp: Date())
let myStruct = MyStruct (
    myArray: [MyData]
)

// 写入正常，但更新报错
db.collection("data").document(document.documentID).updateData(["myArray": FieldValue.arrayUnion([myData])])

核心问题 #

1. 初始结构体使用[String:Any]：Any类型不遵循Codable协议，导致结构体无法满足Decodable要求。
2. 更新时直接传入MyData实例：FieldValue.arrayUnion需要Firestore可识别的原生类型（如字典、基础类型），自定义结构体实例无法直接被解析。
3. 实例化代码错误：[MyData]是类型而非实例，应传入[myData]。
4. 字段名不匹配：原Firestore字段为text，结构体中写为name，会导致数据读写不对应。

解决方案 #

1. 修正结构体与实例化代码 #

确保结构体字段名与Firestore文档完全一致，修正实例化逻辑：

struct MyStruct: Codable {
    @DocumentID var id: String?
    var myArray: [MyData]?
}

struct MyData: Codable {
    var text: String // 匹配Firestore的text字段
    var timestamp: Date
}

// 正确实例化
let myData = MyData(text: "ABCD", timestamp: Date())
let myStruct = MyStruct(myArray: [myData])

2. 正确执行数组更新 #

更新时需将MyData实例转换为Firestore兼容的字典类型，有两种实现方式：

方式一：手动转换为字典

// 将MyData实例转为Firestore可识别的字典
let dataDict: [String: Any] = [
    "text": myData.text,
    "timestamp": myData.timestamp
]

// 执行更新
db.collection("data").document(document.documentID).updateData([
    "myArray": FieldValue.arrayUnion([dataDict])
]) { error in
    if let error = error {
        print("更新失败：\(error.localizedDescription)")
    } else {
        print("数组更新成功")
    }
}

方式二：使用Firestore编码器自动转换

利用Firestore内置编码器将结构体实例转为兼容格式：

do {
    let encodedData = try Firestore.Encoder().encode(myData)
    db.collection("data").document(document.documentID).updateData([
        "myArray": FieldValue.arrayUnion([encodedData])
    ])
} catch {
    print("编码失败：\(error.localizedDescription)")
}

关键总结 #

• 自定义Codable结构体时，必须使用具体类型替代[String:Any]，确保所有属性都遵循Codable协议。
• 操作Firestore数组更新时，不能直接传入自定义结构体实例，需转换为Firestore原生支持的类型（字典/基础类型）。
• 结构体字段名必须与Firestore文档字段严格一致，否则会导致数据解析异常。

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