如何对Firestore Query查询返回的每个文档使用Decodable解析

编译失败的核心原因是 Firestore的Codable解析扩展没有被正确导入，Firestore核心库本身不内置Codable相关能力，这部分功能独立在FirebaseFirestoreSwift组件中。Query返回的文档和直接获取单个文档返回的都是QueryDocumentSnapshot类型，本身完全支持Decodable解析，不存在类型差异。

具体修复步骤 #

• 第一步：确认工程已经引入FirebaseFirestoreSwift依赖
  • CocoaPods：在Podfile中添加pod 'FirebaseFirestoreSwift'，执行pod install生效
  • Swift Package Manager：在项目的Package依赖中添加FirebaseFirestoreSwift产品
• 第二步：在代码文件头部导入该扩展库
• 第三步：优化错误处理逻辑，避免直接用try?吞掉所有错误，方便排查解析过程中出现的字段不匹配等问题

修复后的完整代码 #

import FirebaseFirestore
import FirebaseFirestoreSwift // 必须导入的扩展库

public static func query<T: Codable>(queryFields: [String: Any]) async -> [T] {
    let db = Firestore.firestore()
    var ref: Query = db.collection("myDocuments")
    for (key, value) in queryFields {
        ref = ref.whereField(key, isEqualTo: value)
    }
    
    do {
        let snapshot = try await ref.getDocuments()
        return snapshot.documents.compactMap { document in
            do {
                return try document.data(as: T.self)
            } catch {
                // 可自行打印错误日志排查解析问题
                print("文档\(document.documentID)解析失败：\(error.localizedDescription)")
                return nil
            }
        }
    } catch {
        print("查询失败：\(error.localizedDescription)")
        return []
    }
}

额外注意事项 #

• 如果自定义模型的属性名和Firestore中存储的字段名不一致，需要在模型中定义CodingKey枚举做字段映射
• 如果需要将文档ID也解析到模型属性中，可以给对应的属性添加@DocumentID注解，该注解同样由FirebaseFirestoreSwift提供

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