如何设计Firestore多团队共享文档结构并支持多条件查询？

方案一：用Map存储团队权限（推荐） #

数据库结构调整 #

把原有的单个team字段替换为teams Map类型字段，键为团队ID，值设为true（如果需要区分权限等级，也可以存"read""write"这类具体权限值）。示例文档结构：

{
  "content": "文档内容",
  "searchTerms": ["DOC", "EXAMPLE"],
  "teams": {
    "team_abc123": true,
    "team_def456": true
  }
}

查询逻辑 #

此时团队权限查询转为等于条件，就能和array-contains或范围过滤器组合使用：

firebase.firestore().collection("docs")
  .where(`teams.${token.claims.team}`, "==", true)
  .where("searchTerms", "array-contains", searchTerm.toUpperCase());

这里用Firestore的点表示法直接查询Map内的指定键值对，避开了多array-contains的限制。

安全规则调整 #

更新规则校验用户所属团队是否在文档的teams Map中：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /docs/{doc} {
      allow read, write: if request.auth != null 
        && resource.data.teams[request.auth.token.team] == true;
    }
  }
}

复合索引配置 #

由于使用了==+array-contains的组合查询，需要创建对应复合索引：

• 目标集合：docs
• 索引字段：teams.{teamId}（升序） + searchTerms（升序）

第一次执行查询时，Firestore控制台会自动弹出创建索引的提示链接，直接点击创建即可。

方案二：反向关联团队与文档（适合小体量场景） #

数据库结构调整 #

在每个团队文档下新增docIds数组，存储该团队有权访问的所有文档ID：

// 团队文档 team_abc123
{
  "name": "团队A",
  "docIds": ["doc_1", "doc_2", "doc_3"]
}

查询逻辑 #

1. 先获取当前用户所属团队的docIds数组
2. 用documentId()和in操作符查询主集合：

// 第一步：获取团队可访问的文档ID列表
const teamDoc = await firebase.firestore().collection("teams").doc(token.claims.team).get();
const docIds = teamDoc.data().docIds || [];

// 第二步：批量查询文档（注意：in操作符最多支持10个ID，超过需分批处理）
const querySnapshot = await firebase.firestore().collection("docs")
  .where(firebase.firestore.FieldPath.documentId(), "in", docIds)
  .where("searchTerms", "array-contains", searchTerm.toUpperCase())
  .get();

局限性 #

• in操作符最多支持10个元素，文档数量超过10时需要拆分多次查询
• 维护成本高：文档新增/删除/权限变更时，都要同步更新对应团队的docIds数组

方案三：子集合存储权限记录（适合复杂权限场景） #

数据库结构调整 #

在每个文档下创建teamAccess子集合，每个子文档对应一个有权限的团队：

// 文档 doc_1 下的 teamAccess 子集合
// 子文档 team_abc123
{
  "teamId": "team_abc123",
  "permission": "read"
}
// 子文档 team_def456
{
  "teamId": "team_def456",
  "permission": "write"
}

查询逻辑 #

1. 先查询当前用户所属团队有权访问的文档ID：

const accessSnapshot = await firebase.firestore().collectionGroup("teamAccess")
  .where("teamId", "==", token.claims.team)
  .get();

const docIds = accessSnapshot.docs.map(doc => doc.ref.parent.parent.id);

2. 再用documentId()和in操作符查询主集合（同样受限于10个ID的限制）

局限性 #

• 需要两次查询，复杂度较高
• 集合组查询需要额外配置索引
• 权限变更时需要操作子集合文档，维护成本高

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