如何监听Firestore /uploads/*路径下所有变更，无需逐个绑定监听器

Firestore 的集合监听器默认是浅监听，仅会监听当前集合下直接挂载的文档的增删改查事件，不会递归触发子集合内文档的变更回调，所以你直接监听uploads根集合只能捕获到/uploads/${USER_ID}这一层文档的变更，无法监听到下层items子集合的变动。

方案1：使用集合组查询（推荐，适配现有数据结构） #

集合组查询可以跨所有父路径，监听全局所有名为items的集合的变更，不需要遍历用户目录逐个绑定监听器，性能和单集合监听一致。

前置操作 #

1. 进入Firebase控制台的Cloud Firestore索引页，为items集合创建集合组索引
2. 配置安全规则，开放集合组查询权限，规则示例：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 匹配所有路径下的items集合
    match /{path=**}/items/{itemId} {
      allow read: if true; // 可根据业务权限调整校验逻辑
    }
  }
}

示例代码 #

// 监听全局所有items集合的所有变更
firestore
    .collectionGroup("items")
    .addSnapshotListener(this::onEvent);

// 如果需要筛选仅监听owner为当前用户的文档，可保留筛选条件
firestore
    .collectionGroup("items")
    .whereEqualTo("owner", configService.getUserId())
    .addSnapshotListener(this::onEvent);

方案2：新增全局事件根集合（适合大规模业务场景） #

如果你的uploads目录下除了items还有其他多种子集合需要全局监听，可以调整数据结构，新增一个根级集合upload_events，每次任意uploads路径下发生变更时，同步写入一条事件记录到upload_events集合，只需要监听这个根集合即可拿到所有变更通知，这种方式监听成本更低，查询效率更高。

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