SwiftUI中FirebaseFirestoreSwift解码Firestore数据无显示问题排查

以下是导致列表无数据的核心问题及对应修复方案：

1. 静默忽略解码/查询错误 #

你使用try? snapshot.data(as: Model.self)会吞掉所有解码、查询相关错误，完全无法定位问题根源。必须替换为do-catch捕获并打印错误信息：

修改ViewModel中的查询回调部分：

addSnapshotListener { (querySnapshot, error) in
    // 先处理查询本身的错误
    if let error = error {
        print("DEBUG: 查询失败: \(error)")
        return
    }
    
    guard let documents = querySnapshot?.documents else {
        print("DEBUG: 无文档返回")
        return
    }
    
    self.items = documents.compactMap { snapshot -> Model? in
        do {
            return try snapshot.data(as: Model.self)
        } catch {
            print("DEBUG: 解码文档失败: \(error)")
            return nil
        }
    }
}

2. 自定义CodingKeys冗余且可能引发冲突 #

你的Model中自定义了CodingKeys，但没有字段重命名等特殊需求，完全可以删除——默认的Codable实现会自动匹配所有属性。保留自定义CodingKeys反而可能干扰@DocumentID的特殊映射逻辑，导致解码异常。

简化后的Model代码：

public struct Model: Identifiable, Hashable, Codable, Equatable {
    @DocumentID public var id: String? = UUID().uuidString
    let item0: String
    let item1: String
    let timestamp: Timestamp
}

3. 查询排序字段"uid"存在问题 #

你的查询使用了.order(by: "uid")，但Model中并未定义uid属性，且Firestore文档中如果没有该字段、或未创建对应查询索引，都会导致查询失败：

• 检查Firestore的items集合文档，确认是否存在uid字段
• 如果不需要按uid排序，直接移除该排序条件
• 如果必须保留排序，需在Firestore控制台创建对应的索引（若查询包含其他过滤条件，可能需要复合索引）

4. 检查Firestore安全规则 #

默认的Firestore安全规则是禁止所有读写操作的，若未修改规则，会导致无法获取数据。测试阶段可临时设置为：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

注意上线前必须修改为符合业务需求的安全规则。

额外验证点 #

• 确认GoogleService-Info.plist已正确添加到项目中，Firebase配置完成
• 若安全规则要求用户认证，需确保模拟器中已登录Firebase用户
• 检查Firestore的items集合中，文档的item0、item1、timestamp字段类型与Model定义一致（比如timestamp必须是Firestore原生Timestamp类型，不能是字符串或Date）

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