Firestore collectionGroup按userId查询experience子集合返回空问题

你当前使用的Firestore结构为：所有游戏数据存在games集合下，每个game文档下嵌套experience子集合，子集合内的每个文档ID对应用户的userId，文档内仅存储experience经验值字段，结构参考：

你通过客户端转换器将文档ID挂载为返回实体的userId属性，转换逻辑如下：

experienceEntity.userId = snapshot.id;
experienceEntity.experience = snapshot.data().experience;

你尝试通过集合组查询+userId字段过滤的方式查询指定用户的所有经验记录，但加过滤条件后始终返回空数组，去掉过滤则可以返回全量数据。

查询返回空数组的核心原因是：

• Firestore集合组查询的过滤逻辑在服务端执行，只能匹配文档内实际存储的原生字段，不会运行你在客户端定义的数据转换器代码。
• 你代码里的userId属性是转换器拿到查询结果后，在客户端手动从文档ID挂载到实体对象上的，服务端存储的experience文档本身并没有userId这个字段，加where条件后服务端匹配不到对应字段值，自然返回空结果。
• 去掉where条件能正常返回全量数据，是因为此时不需要服务端做过滤，全量文档拉到客户端后，转换器可以正常执行赋值逻辑。

你的场景是跨所有games文档查询experience子集合下指定用户的记录，且后续数据量会达到百万级，优先选择以下方案：

方案1：调整文档存储结构（推荐，性能满足百万级规模） #

将userId作为实际字段写入每个experience文档中，不要仅依赖转换器从文档ID读取。
调整写入逻辑示例：

// 写入experience记录时，除了存experience值，同步把userId作为原生字段存入文档
await firestore()
  .collection("games")
  .doc(gameId)
  .collection("experience")
  .doc(userId) // 文档ID仍然可以保留用userId，不影响原有逻辑
  .set({
    experience: 对应经验值,
    userId: userId // 新增该存储字段
  })

对于已经存在的存量数据，写个一次性脚本遍历所有experience文档，给每个文档补上userId字段即可。
调整完成后，你原来的查询代码不需要改动逻辑，只需要在Firestore控制台为experience集合组的userId字段创建对应查询索引（第一次执行查询时控制台会报索引缺失错误，按报错引导一键创建即可），就能正常返回过滤后的结果，查询性能在百万级数据下完全符合要求。

不可行方案说明 #

• 不要尝试直接用documentId()伪字段做集合组过滤来实现你的需求：Firestore集合组查询中通过documentId()做相等匹配时，要求传入文档的完整路径（格式为games/{gameId}/experience/{userId}），你无法提前枚举所有gameId来拼接全路径，没法实现跨所有game的匹配。
• 不要尝试拉取全量experience数据后在客户端做过滤：百万级数据规模下会产生极高的读成本、流量消耗和等待时长，完全不具备可行性。

内容的提问来源于stack exchange，提问作者Maksym B.