Firestore集合组按documentId查询报路径段错误该如何解决？

报错原因 #

Firestore 集合组查询场景中，FieldPath.documentId() 匹配的是包含完整父层级的文档绝对路径（例如teams/xxx/members/xxx），而非单独的文档ID，路径的段数固定为偶数，你传入的单段UID自然不符合校验规则，因此触发报错。

可选解决方案（并非只能通过写入文档字段实现） #

方案1：构造完整路径查询（无需修改存量数据） #

如果你的所有members集合都属于固定的父层级结构，例如统一为{父集合}/{父文档ID}/members/{uid}的格式，你可以先拉取所有父级文档的ID，拼接出对应UID的完整members文档路径，再用路径做集合组查询：

// 示例：假设所有members都在teams/{teamId}/members/路径下
const teamList = await this.db.firestore.collection('teams').get();
const fullMemberPaths = teamList.docs.map(teamDoc => `teams/${teamDoc.id}/members/${uid}`);

const finalQuery = this.db.firestore
  .collectionGroup('members')
  .orderBy('dateModified', 'desc')
  .where(firebase.firestore.FieldPath.documentId(), 'in', fullMemberPaths);

注意：Firestore的in查询单次最多支持10个值，若父级文档数量超过10个，需拆分做分批查询。

方案2：批量同步文档ID到文档字段（一劳永逸，适配所有场景） #

不需要手动修改存量数据，只需运行一次批量更新脚本，遍历所有members集合的文档，新增uid字段取值为文档ID即可，操作成本极低：

// 批量更新示例
const allMembers = await this.db.firestore.collectionGroup('members').get();
const batch = this.db.firestore.batch();
allMembers.docs.forEach(memberDoc => {
  batch.update(memberDoc.ref, { uid: memberDoc.id });
});
await batch.commit();

更新完成后，后续查询直接使用where('uid', '==', uid)做集合组查询即可，新写入的members文档同步添加该字段即可长期使用。

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