Swift Firestore异步闭包赋值后无法正确返回值问题

getDocuments 是异步网络请求方法，调用后不会阻塞当前线程等待Firestore返回结果：

• 你传入getDocuments的闭包会被暂存，直到网络请求完成、Firestore返回数据后才会被调度执行
• 调用getDocuments后代码会立刻向下执行，直接走到return retData行，此时闭包内给retData赋值的逻辑还未运行，因此返回值永远是函数开头初始化的默认值
• 闭包确实捕获了retData变量，但赋值动作发生在函数return完成之后，外部已经拿到了返回值，后续的修改不会同步到已经返回出去的结构体实例（结构体是值类型）。同步return的写法完全不适用于这类异步场景。

异步操作无法通过同步return返回结果，需要通过逃逸闭包回调或者Swift 5.5+支持的async/await语法接收结果。

方案1： 兼容旧版本的闭包回调实现 #

将方法改为传入完成回调，等网络请求返回后把结果通过回调抛给调用方：

func getArtistProfileCardData(artistName: String, completion: @escaping (Result<UserModel, Error>) -> Void) {
    // 预置默认值，无匹配结果时返回
    let defaultUser = UserModel(
        isArtist: false, 
        first: "", 
        last: "", 
        artistName: "something", 
        occupation: "", 
        profileUrl: "", 
        followers: 0
    )
    
    let usersRef = db.collection("users")
    usersRef.whereField("artistName", isEqualTo: artistName)
        .getDocuments { querySnapshot, err in
            // 优先处理请求错误
            if let err = err {
                print("Error getting documents: \(err)")
                completion(.failure(err))
                return
            }
            
            guard let documents = querySnapshot?.documents, let matchDoc = documents.first else {
                // 无匹配文档时返回默认值，也可根据业务返回自定义错误
                completion(.success(defaultUser))
                return
            }
            
            do {
                let userData = try matchDoc.data(as: UserModel.self)
                completion(.success(userData))
            } catch {
                print("Error parsing user data: \(error)")
                completion(.failure(error))
            }
        }
}

调用方式如下，所有拿到数据后的逻辑（包括UI更新）必须写在回调闭包内：

getArtistProfileCardData(artistName: "目标艺术家名称") { result in
    switch result {
    case .success(let user):
        // 此处拿到正确的UserModel数据，执行后续业务逻辑
        // 要更新UI的话记得手动切回主线程：DispatchQueue.main.async { /* 更新UI */ }
        print("查询到艺术家：\(user.artistName)")
    case .failure(let error):
        // 处理查询/解析错误，比如给用户展示失败提示
        print("查询失败：\(error.localizedDescription)")
    }
}

如果你的业务中artistName字段可能对应多个用户，不要直接取documents.first，自行遍历documents做筛选匹配即可。

方案2： Swift 5.5+ async/await 实现（更简洁） #

如果项目支持Swift 5.5以上版本，可以直接用Firestore提供的异步接口，避免回调嵌套：

func getArtistProfileCardData(artistName: String) async throws -> UserModel {
    let defaultUser = UserModel(
        isArtist: false, 
        first: "", 
        last: "", 
        artistName: "something", 
        occupation: "", 
        profileUrl: "", 
        followers: 0
    )
    
    let usersRef = db.collection("users")
    let querySnapshot = try await usersRef.whereField("artistName", isEqualTo: artistName).getDocuments()
    
    guard let matchDoc = querySnapshot.documents.first else {
        return defaultUser
    }
    
    return try matchDoc.data(as: UserModel.self)
}

调用时用await关键字接收结果，配合do/catch处理错误：

Task {
    do {
        let user = try await getArtistProfileCardData(artistName: "目标艺术家名称")
        // 拿到数据后执行后续逻辑
        print("查询到艺术家：\(user.artistName)")
    } catch {
        print("查询失败：\(error.localizedDescription)")
    }
}

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