Firestore按UID查询需逐用户创建索引问题排查与解决

一、失效单字段豁免配置删除方法 #

控制台点击配置无响应基本都是前端缓存或权限校验异常导致，按以下步骤操作即可删除：

• 首先确认当前登录账号拥有项目的Firestore管理员或所有者权限，权限不足时会出现操作菜单不弹出的问题
• 优先使用gcloud命令行删除，绕开控制台前端异常：
  1. 本地安装gcloud CLI后执行gcloud auth login完成账号登录
  2. 执行gcloud config set project 你的Firebase项目ID切换到目标项目
  3. 执行gcloud firestore indexes fields list拉取全量字段索引配置，定位到你创建的User.ID对应豁免条目，复制条目的name字段完整值
  4. 执行gcloud firestore indexes fields delete 刚才复制的name值，确认操作后输入y即可完成删除
• 控制台缓存的失效条目一般会在删除操作完成后5-10分钟内自动同步消失，若急需操作可使用浏览器无痕模式重新进入控制台索引页，缓存清空后即可看到配置项的删除操作按钮。

二、避免为每个用户UID单独创建索引的配置方案 #

之前出现每新增用户就提示建索引、单字段豁免不生效的核心原因，是数据建模逻辑存在问题：把动态生成的用户UID直接作为了文档字段名使用，而配置的单字段豁免只对字段名固定为User.ID的字段生效，和实际写入的动态UID字段名完全不匹配，自然无法命中规则。Firestore的索引是按固定字段名生成的，动态值作为字段名时，每出现一个新字段名就会触发新的复合索引要求，不可能靠提前建索引覆盖。
按以下方案调整即可一劳永逸解决问题：

• 第一步调整数据结构：废弃把UID作为字段名的写法，所有任务文档统一使用固定字段键存储关联用户ID，例如固定用ownerUid字段存储对应用户的UID字符串，priority字段保持原有固定命名存储优先级值，不再使用动态值作为字段键
• 第二步创建唯一的固定复合索引：进入Firestore索引页，新建复合索引，选择任务对应的集合，按查询顺序添加字段：先加ownerUid（等值查询场景下升序/降序无影响），再加priority（按业务查询的排序需求选择升序或降序），如果需要跨同名集合组查询就开启集合组范围，否则保持单集合范围即可
• 索引创建完成后，所有用户的按ownerUid筛选+按priority筛选/排序的查询都可以复用这一个索引，完全不需要为单个用户单独建索引

注意：不要尝试通过配置全字段豁免的方式绕开索引要求，这种方式会导致查询退化为全表扫描，不仅延迟极高，还会产生超额的读操作费用，性能和成本都不可接受。

内容的提问来源于stack exchange，提问作者mukesh raj dass