Swift使用结构体解码Firebase实时数据库快照返回nil排查

你解码返回nil的核心原因：Firebase实时数据库通过observeSingleEvent返回的.value快照，对于childByAutoId()生成的子节点列表，返回的根结构是以自动生成的push ID为key、子节点数据为value的字典，而非直接的数组结构。你当前代码直接尝试将整体数据解码为[PromoCode]数组类型，和实际返回的结构不匹配，加上用try?吞掉了解码错误，所以始终拿到nil。

你当前拿到的快照实际结构如下：

对应等价JSON结构为：

{
  "-Nl9xxxx（自动生成的pushID）": {
    "amount": 100,
    "code": "PROMO100"
  },
  "-NlAxxxx（自动生成的pushID）": {
    "amount": 50,
    "code": "PROMO50"
  }
}

方案1：使用Firebase SDK内置解码（官方推荐，最稳定） #

Firebase SDK本身提供了直接将DataSnapshot解码为Codable模型的方法，不需要手动经过JSONSerialization中转，出错率更低。

import FirebaseDatabase

struct PromoCode: Codable {
    var amount: Int
    var code: String
}

func getPromoCodes(handler: @escaping ([PromoCode]?) -> ()) {
    promoCodes.observeSingleEvent(of: .value) { snapshot in
        do {
            // 先解码为[String: PromoCode]字典，匹配快照实际结构
            let promoDict = try snapshot.data(as: [String: PromoCode].self)
            // 提取字典value得到目标数组
            let codes = Array(promoDict.values)
            handler(codes)
        } catch {
            // 开发阶段打印错误，方便定位问题
            print("解码错误: \(error)")
            handler(nil)
        }
    }
}

方案2：手动转JSON解码（兼容原有逻辑） #

如果你需要保留原有JSONSerialization转数据的逻辑，只需要修正解码的目标类型，不要吞掉解码错误即可：

func getPromoCodes(handler: @escaping ([PromoCode]?) -> ()) {
    promoCodes.observeSingleEvent(of: .value) { snapshot in
        print("SNAPSHOT: \(snapshot.value)")
        guard let snapshotValue = snapshot.value as? [String: Any],
              let jsonData = try? JSONSerialization.data(withJSONObject: snapshotValue, options: []) else {
            handler(nil)
            return
        }
        do {
            // 匹配实际结构先解码字典
            let promoDict = try JSONDecoder().decode([String: PromoCode].self, from: jsonData)
            let codes = Array(promoDict.values)
            handler(codes)
        } catch {
            print("JSON解码错误: \(error)")
            handler(nil)
        }
    }
}

• 开发阶段不要直接用try?忽略解码错误，通过do-catch捕获并打印错误，可以快速定位字段不匹配、类型错误等问题。
• 从字典提取生成的数组默认是无序的，如果需要和控制台展示顺序一致，可以按push ID排序，或者在模型中加排序字段后按业务字段排序。
• 优先使用Firebase SDK内置的解码方法，避免手动JSON转换带来的类型兼容问题。

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