Swift中如何让Firebase异步读取函数返回QuerySnapshot？

这个问题我太熟悉了！核心原因是Firebase的getDocuments是异步执行的——你的read()函数会在网络请求完成、闭包内的代码执行之前就已经结束运行，所以直接尝试返回QuerySnapshot或者documents肯定会抛出"返回非void值"的错误。

下面给你两种实用的解决方案，根据你的iOS版本选择即可：

方案一：使用Completion Handler（兼容所有iOS版本） #

这种方法是处理异步任务的经典方式，通过闭包回调把结果返回给调用者：

import FirebaseFirestore

func readUsers(completion: @escaping (Result<[DocumentSnapshot], Error>) -> Void) {
    let db = Firestore.firestore()
    db.collection("users").getDocuments { querySnapshot, error in
        // 优先处理错误
        if let error = error {
            completion(.failure(error))
            return
        }
        
        // 确认拿到文档数组后返回
        guard let documents = querySnapshot?.documents else {
            let emptyError = NSError(domain: "FirebaseReadError", code: -1, userInfo: [
                NSLocalizedDescriptionKey: "未获取到任何用户文档"
            ])
            completion(.failure(emptyError))
            return
        }
        
        completion(.success(documents))
    }
}

调用方式： #

在视图控制器中调用时，通过闭包接收结果：

readUsers { result in
    switch result {
    case .success(let documents):
        // 在这里处理拿到的用户文档数组
        for document in documents {
            print("用户数据：\(document.data())")
        }
    case .failure(let error):
        print("读取用户失败：\(error.localizedDescription)")
    }
}

方案二：使用Async/Await（iOS 15+、macOS 12+ 推荐） #

Swift 5.5及以上版本支持async/await语法，Firebase也提供了对应的异步API，能让异步代码看起来像同步代码一样简洁：

import FirebaseFirestore

func readUsers() async throws -> [DocumentSnapshot] {
    let db = Firestore.firestore()
    // 用try await等待异步请求完成
    let querySnapshot = try await db.collection("users").getDocuments()
    return querySnapshot.documents
}

调用方式： #

需要在async上下文（比如Task）中调用：

override func viewDidLoad() {
    super.viewDidLoad()
    
    Task {
        do {
            let documents = try await readUsers()
            // 处理用户文档
            for document in documents {
                print("用户数据：\(document.data())")
            }
        } catch {
            print("读取用户失败：\(error.localizedDescription)")
        }
    }
}

注意事项 #

千万别尝试用信号量（DispatchSemaphore）强行把异步代码改成同步执行——这样会阻塞主线程，导致APP卡顿甚至无响应，严重影响用户体验。

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