Swift中使用Firestore出现‘考虑使用异步替代函数’警告的原因

警告原因分析 #

• Consider using asynchronous alternative function：你当前使用的是闭包回调版本的getDocuments，Firebase官方推荐使用Swift原生的async/await异步替代方案，这是现代Swift异步编程的标准写法。
• “无异步调用，无需使用”：你的函数标记了async throws，但内部没有任何await调用，不符合异步函数的定义规范，编译器因此提示冗余标记。

修正后的代码 #

class UserServices {
    
    private let db = Firestore.firestore()
    static let shared = UserServices()
    
    func checkUsernameAvailability(newUsername: String) async throws -> Bool {
        // 使用async/await版本的getDocuments，替代闭包回调
        let querySnapshot = try await db.collection("usernames").getDocuments()
        // 提取所有用户名（documentID）
        let usernames = querySnapshot.documents.map { $0.documentID }
        // 返回是否存在
        return usernames.contains(newUsername)
    }
}

关键修改点说明 #

1. 函数签名优化：移除逃逸闭包参数doesExists，直接返回Bool类型，利用async throws的特性传递异步结果和错误，更符合Swift异步编程范式。
2. 替换异步调用方式：用try await调用Firestore提供的getDocuments()异步版本，既消除了Firebase的警告，也让函数内部有了合法的await调用，解决了“无异步调用”的警告。
3. 简化逻辑：用map替代循环遍历，直接提取所有documentID，代码更简洁高效。
4. 错误处理规范：函数通过throws抛出Firestore请求的错误，调用方可以通过do-catch块捕获处理，替代了之前直接返回true的不合理错误处理逻辑。

调用示例 #

// 在异步上下文调用（比如Task或async函数内）
Task {
    do {
        let isExists = try await UserServices.shared.checkUsernameAvailability(newUsername: "testUser")
        print("用户名是否存在：\(isExists)")
    } catch {
        print("检查用户名失败：\(error)")
    }
}

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