Swift中Firestore非空对象数组learntChants返回nil问题

1. 模型字段映射不匹配（核心原因） #

Firestore后台字段是learnt_chants（蛇形命名），但Swift模型中属性是learntChants（驼峰命名）。如果你的User模型采用Codable解析Firestore数据，默认不会自动完成蛇形与驼峰的转换，必须显式定义CodingKeys：

struct User: Codable {
    var userId: String
    var learntChants: [LearntChant]? // 类型需与Firestore中数组元素匹配

    enum CodingKeys: String, CodingKey {
        case userId
        case learntChants = "learnt_chants" // 显式映射Firestore字段名
    }
}

struct LearntChant: Codable {
    var chantId: String
    var voteType: String
}

没有这个映射的话，Firestore解析器会找不到对应字段，直接返回nil。

2. 代码中的低级语法错误 #

在map闭包中，你错误地用数组learntChants取键值，应该使用当前遍历的元素learntChant：

// 错误写法
let chant = LearntChant(chantId: learntChants["chantId"] as? String ?? "none", voteType: learntChants["voteType"] as? String ?? "none")

// 正确写法
let chant = LearntChant(chantId: learntChant["chantId"] as? String ?? "none", voteType: learntChant["voteType"] as? String ?? "none")

这个错误会导致编译失败，即使强行运行也无法提取有效数据。

3. 模型类型定义不匹配 #

检查User模型中learntChants的类型：

• 如果Firestore中learnt_chants是自定义对象数组，模型中应定义为[LearntChant]?，而非Any?或[String]?
• 如果是手动解析（非Codable），需确保getUser方法将Firestore的Array<[String:Any]>正确转为[LearntChant]

4. 检查userManager.getUser的实现 #

确保getUser方法正确解析Firestore文档：

• 若使用Codable：

  func getUser(userId: String) async throws -> User {
      let doc = try await Firestore.firestore().collection("users").document(userId).getDocument()
      guard let user = try? doc.data(as: User.self) else {
          throw NSError(domain: "UserError", code: -1, userInfo: [NSLocalizedDescriptionKey: "Failed to parse user"])
      }
      return user
  }
  

• 若手动解析：

  func getUser(userId: String) async throws -> User {
      let doc = try await Firestore.firestore().collection("users").document(userId).getDocument()
      guard let data = doc.data() else {
          throw NSError(domain: "UserError", code: -1, userInfo: [NSLocalizedDescriptionKey: "User not found"])
      }
      let userId = data["userId"] as? String ?? ""
      let learntChantsData = data["learnt_chants"] as? [[String:Any]] ?? []
      let learntChants = learntChantsData.map {
          LearntChant(chantId: $0["chantId"] as? String ?? "none", voteType: $0["voteType"] as? String ?? "none")
      }
      return User(userId: userId, learntChants: learntChants)
  }
  

验证步骤 #

1. 确认User模型的CodingKeys是否正确映射learnt_chants
2. 修正map闭包中的元素引用错误
3. 检查getUser方法的解析逻辑
4. 重新运行后打印user.learntChants，确认数据加载状态

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