如何将Firebase文档映射为Swift模型 解析结构体数组字段

let newItem = data["newItems"] as? [Item] ?? [] 写法失效的核心原因是：Firestore 的 data() 方法返回值为 [String: Any] 类型字典，其中 newItems 字段读取到的实际类型是字典数组 [[String: Any]]，而非自定义的 Item 结构体数组，Swift 无法直接在无转换逻辑的前提下将字典强转为自定义结构体类型。

两种方案都可实现映射，优先选择第一种，代码维护成本最低。

方案1：基于Firestore自带Codable能力解码（推荐） #

你的 Room、Item 结构体已经实现了 Codable 协议，不需要手动逐字段取值映射，直接调用Firestore提供的解码方法即可自动完成所有字段（包括嵌套的newItems数组）的解析：

1. 首先在Auth.swift文件顶部添加导入语句：

   import FirebaseFirestoreSwift
   

2. 将原来的文档映射逻辑替换为如下代码：

   self.rooms = doc.compactMap { docSnapshot -> Room? in
       do {
           // 自动将文档数据解码为Room模型
           var room = try docSnapshot.data(as: Room.self)
           // 手动赋值文档ID（文档ID不存在于普通字段中）
           room.id = docSnapshot.documentID
           return room
       } catch {
           print("Room数据解码失败: \(error)")
           return nil
       }
   }
   

这种写法会自动处理嵌套数组、类型匹配的逻辑，后续如果Room或Item新增字段，不需要修改解析代码。

方案2：手动逐字段解析 #

如果你需要完全手动控制解析逻辑，可先将newItems转为字典数组，再遍历字典逐个构造Item实例：

self.rooms = doc.map { docSnapshot -> Room in
    let data = docSnapshot.data()
    let docId = docSnapshot.documentID
    let title = data["title"] as? String ?? ""
    let members = data["members"] as? [String] ?? []
    
    // 先取出字典格式的item数组
    let itemDictList = data["newItems"] as? [[String: Any]] ?? []
    // 遍历字典构造Item实例
    let newItems: [Item] = itemDictList.map { itemDict in
        Item(
            id: itemDict["id"] as? String,
            name: itemDict["name"] as? String ?? "",
            desc: itemDict["desc"] as? String ?? "",
            qty: itemDict["qty"] as? String ?? "",
            assignedTo: itemDict["assignedTo"] as? String ?? ""
        )
    }

    return Room(id: docId, title: title, newItems: newItems, members: members)
}

• 确保结构体属性名和Firestore中存储的字段名完全一致（大小写敏感），如果存在命名差异，可通过CodingKeys自定义映射规则
• 可选类型属性要和Firestore中字段的存在性匹配，避免因字段缺失导致强转失败
• 方案1依赖FirebaseFirestoreSwift模块，必须完成对应导入才能正常调用解码方法

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