Swift调用Firestore的.getDocuments()返回nil并触发解包致命错误求助

核心问题1：异步操作导致提前返回nil #

getDocuments是异步执行的网络请求，你的函数会在Firestore请求完成前就返回customers——此时customers作为隐式解包的可选值还未被赋值，直接返回就会触发"Unexpectedly found nil"错误。

核心问题2：强制解包存在崩溃风险 #

代码里querySnapshot!.documents使用了强制解包，如果Firestore返回的快照为nil（比如网络异常），这里会直接引发崩溃。

修复后的代码（使用闭包处理异步结果） #

func getAllTasks(completion: @escaping ([String: Any]?, Error?) -> Void) {
    let db = Firestore.firestore()
    
    db.collection("CustomerCollection").whereField("uploaded", isEqualTo: true)
        .getDocuments() { (querySnapshot, err) in
            if let err = err {
                print("Error getting documents: \(err)")
                completion(nil, err)
                return
            }
            
            // 安全获取文档列表
            guard let documents = querySnapshot?.documents else {
                completion(nil, nil)
                return
            }
            
            // 注意：原代码循环会覆盖数据，此处保留原逻辑返回最后一个文档
            // 若需获取所有文档，可改为数组存储：var allCustomers = [[String: Any]]()，循环中append
            let lastCustomer = documents.last?.data()
            completion(lastCustomer, nil)
    }
}

调用示例 #

getAllTasks { customer, error in
    if let error = error {
        print("获取数据失败：\(error)")
        return
    }
    guard let customer = customer else {
        print("未找到符合条件的数据")
        return
    }
    print("获取到的数据：\(customer)")
}

额外提示 #

• 原代码中循环赋值customers = document.data()会持续覆盖之前的数据，最终仅保留最后一个文档内容；如果需要所有符合条件的文档，建议将返回类型改为[[String: Any]]（字典数组），在循环中用customers.append(document.data())收集数据。
• 日常开发中避免不必要的隐式解包（!），优先用if let/guard let安全处理可选值。

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