Swift中如何通过Firestore根据UID数组查询Player文档？

你当前实现的问题 #

• 第一个方案：直接把playersUID数组传给查询条件，Firestore会将其作为数组类型进行匹配，但你的Player文档中存储的是单个玩家ID（不是数组），自然无法返回结果。
• 第二个方案：错误地将字符串类型的UID转为Int作为循环索引上限，这完全不符合逻辑（UID不是数字），会导致循环范围错误甚至崩溃；而且多次循环查询Firestore效率极低，还会浪费请求配额。

Firestore 专属解决方案：使用whereField(_:in:) #

Firestore提供了whereField(_:in:)方法，能一次性查询字段值在指定数组内的所有文档，完美匹配你的需求，分两种场景处理：

场景1：Player文档ID就是玩家UID

如果你的Players集合中，每个文档的ID直接对应玩家的UID，直接通过文档ID查询：

func searchPlayers() async {
    do {
        // 直接查询文档ID在playersUID数组内的Player文档
        let documents = try await Firestore.firestore().collection("Players")
            .whereField(FieldPath.documentID(), in: tournament.playersUID)
            .getDocuments()
        
        // 解析查询结果
        let players = try documents.documents.compactMap { try $0.data(as: Player.self) }
        
        // 更新主线程的数组
        await MainActor.run {
            fetchedPlayers.append(contentsOf: players)
        }
    } catch {
        print("查询玩家失败：\(error.localizedDescription)")
    }
}

场景2：Player文档包含单独的uid字段

如果你的Player结构体里有专门的uid字段存储玩家ID，直接查询该字段：

// 先确保Player结构体有uid字段
struct Player: Identifiable, Codable, Equatable, Hashable {
    var uid: String
    // 其他字段...
}

func searchPlayers() async {
    do {
        let documents = try await Firestore.firestore().collection("Players")
            .whereField("uid", in: tournament.playersUID)
            .getDocuments()
        
        let players = try documents.documents.compactMap { try $0.data(as: Player.self) }
        
        await MainActor.run {
            fetchedPlayers.append(contentsOf: players)
        }
    } catch {
        print("查询玩家失败：\(error.localizedDescription)")
    }
}

额外注意事项 #

• 确保tournament.playersUID数组中的UID与Player文档的ID/uid字段完全匹配（大小写、特殊字符都不能出错）。
• 可以先判断tournament.playersUID是否为空，避免发起无意义的查询。
• 不要使用循环逐个查询，whereField(_:in:)是单次批量查询，性能和成本都更优。

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