iOS Firestore聊天应用map中Completion Handler异步返回空值问询

根本原因 #

你遇到的问题本质是同步函数无法直接返回异步操作的结果。所有Firestore的getDocument请求都是异步执行的，函数执行到return语句时，网络请求还没有返回，自然拿不到结果。你需要放弃「直接返回值」的写法，改用异步回调或者async/await模式接收结果。

方案1：DispatchGroup + 异步回调（全系统版本兼容） #

把getParticipantNames改为带逃逸回调的形式，所有请求完成后通过回调返回结果：

func getParticipantNames(members: [String], patientID: String, completion: @escaping ([String]) -> Void) {
    let messageParticipantIDs = members.filter { $0 != patientID }
    let group = DispatchGroup()
    var names: [String] = []
    // 保证数组操作都在主队列执行，避免线程安全问题
    let queue = DispatchQueue.main
    
    for participantID in messageParticipantIDs {
        group.enter()
        UserData(id: participantID).getUserName { name in
            queue.async {
                names.append(name)
                group.leave()
            }
        }
    }
    
    // 所有请求完成后触发回调
    group.notify(queue: queue) {
        completion(names)
    }
}

// UserData中的getUserName优化写法（避免强制解包崩溃）
func getUserName(completionHandler: @escaping (String) -> Void) {
  let docRef = ...
    
  docRef.getDocument { (document, error) in
    guard let document = document, 
          let data = document.data(),
          let firstName = data["firstName"] as? String,
          let lastName = data["lastName"] as? String else {
        // 出错可返回默认值，自行调整逻辑
        completionHandler("未知用户")
        return
    }
    completionHandler(firstName + " " + lastName)
  }
}

调用时通过回调接收结果：

getParticipantNames(members: 成员数组, patientID: 患者ID) { names in
    // 在这里拿到最终的姓名数组做后续操作，比如刷新UI
    print("最终姓名列表：\(names)")
}

方案2：async/await（支持iOS 15+ / Swift 5.5+） #

写法更简洁，不需要嵌套回调：

// 先把getUserName改造为async函数
func getUserName() async -> String {
    let docRef = ...
    do {
        let document = try await docRef.getDocument()
        guard let data = document.data(),
              let firstName = data["firstName"] as? String,
              let lastName = data["lastName"] as? String else {
            return "未知用户"
        }
        return firstName + " " + lastName
    } catch {
        return "未知用户"
    }
}

// getParticipantNames也改成async函数
func getParticipantNames(members: [String], patientID: String) async -> [String] {
    let messageParticipantIDs = members.filter { $0 != patientID }
    var names: [String] = []
    // 并发请求所有用户数据
    await withTaskGroup(of: String.self) { group in
        for participantID in messageParticipantIDs {
            group.addTask {
                await UserData(id: participantID).getUserName()
            }
        }
        // 收集所有返回结果
        for await name in group {
            names.append(name)
        }
    }
    return names
}

调用时用await接收结果：

Task {
    let names = await getParticipantNames(members: 成员数组, patientID: 患者ID)
    // 后续操作
}

注意点 #

• 不要用!强制解包Firestore返回的字段，改用可选绑定避免数据异常导致崩溃
• 多个异步回调修改同一个变量时，要保证操作在同一个串行队列执行，避免数据竞争

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