将Firebase快照转换为数据模型数组时出现nil值的问题排查

一、第一种实现（获取nil值）的核心问题 #

1. 数据模型初始化错误 #

OtherObjectsDataModel的init(snapshot:)方法中，仅在if let块内声明了局部变量，未将值赋值给类的属性。比如let date = dict["Date"] as? String只是创建了局部变量，并未给self.date赋值，导致所有属性保持默认的nil。

2. 冗余监听与错误遍历逻辑 #

已经从objectsRef.observe(.value)的快照中拿到了对应单个OtherObject节点的child快照，却额外发起objectsRef.child("\(orderID)").observe(.value)请求，属于冗余操作。同时遍历snapshot.children逻辑错误——childByAutoID对应的快照是单个对象的字典结构，并非子节点列表，遍历它的children只能拿到单个键值对，无法获取完整对象。

二、第二种实现（数组为空）的核心问题 #

1. 异步逻辑误解 #

Firebase的observe是异步执行的，调用getByAutoID()后函数会立刻返回，但数据还未从Firebase拉取完成。如果在函数执行完后立刻访问otherObjectsData，数组必然为空。

2. 错误的字典遍历逻辑 #

遍历单个对象的字典snapshotValue的键值对，会导致每个键值对都创建一次OtherObjects实例，重复添加对象，且逻辑完全错误——单个对象的字典无需遍历，直接提取字段即可。

3. 字段名不匹配与强制解包风险 #

• 数据库中的ObjectCategory、ObjectType、ImgURI与模型中的category、type、imgURI字段名不匹配，导致赋值失败。
• 使用!强制解包，若数据库中字段缺失或类型不匹配，会直接引发崩溃。

修复后的代码示例 #

1. 修正数据模型类 #

import Foundation
import Firebase

class OtherObjectsDataModel {
    var date: String?
    var email: String?
    var name: String?
    var category: String?
    var type: String?
    var lat: Double?
    var lon: Double?
    var city: String?
    var address: String?
    var description: String?
    var imgURI: String?
    var imgName: String?
    
    init(snapshot: DataSnapshot) {
        guard let dict = snapshot.value as? [String: Any] else { return }
        // 字段名需与Firebase数据库完全匹配（包括大小写）
        self.date = dict["Date"] as? String
        self.email = dict["Email"] as? String
        self.name = dict["Name"] as? String
        self.category = dict["ObjectCategory"] as? String
        self.type = dict["ObjectType"] as? String
        self.lat = dict["Latitude"] as? Double
        self.lon = dict["Longitude"] as? Double
        self.city = dict["City"] as? String
        self.address = dict["Address"] as? String
        self.description = dict["Description"] as? String
        self.imgURI = dict["ImgURI"] as? String
        self.imgName = dict["imgName"] as? String
    }
}

2. 修正后的获取数据方法（推荐方案） #

var otherObjectsData: [OtherObjectsDataModel] = []
// 添加闭包回调，数据加载完成后通知外部
func getOtherObjects(completion: @escaping () -> Void) {
    let objectsRef = Database.database().reference().child("OtherObjects")
    // 仅获取一次数据，无需实时监听
    objectsRef.observeSingleEvent(of: .value, with: { snapshot in
        self.otherObjectsData.removeAll()
        guard let children = snapshot.children.allObjects as? [DataSnapshot] else {
            completion()
            return
        }
        for child in children {
            let model = OtherObjectsDataModel(snapshot: child)
            self.otherObjectsData.append(model)
        }
        completion() // 数据加载完成，触发回调
    })
}

// 使用方式：
getOtherObjects {
    // 此处可安全访问otherObjectsData，数据已加载完成
    print(self.otherObjectsData.count)
}

额外注意事项 #

• 优先使用observeSingleEvent(of: .value)而非observe(.value)，除非需要实时监听数据变化——后者会在数据每次更新时触发，可能导致重复添加数据。
• 避免在模型类中持有DatabaseReference，建议在ViewModel或控制器中统一管理数据库引用。
• 禁止用!强制解包Firebase返回的数据，使用as?配合可选绑定，保证代码健壮性。

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