如何为Firebase布尔字段创建复合索引？解决PHP查询索引报错问题

针对你遇到的FailedPreconditionException（提示需要复合索引），手动创建索引后仍报错的情况，按以下步骤排查：

• 严格匹配索引字段顺序
  你的查询逻辑是先按date降序排序，再过滤isDeleted=false的文档，因此复合索引的字段顺序必须和查询逻辑一致：第一个字段为date（排序方向设为DESC），第二个字段为isDeleted（排序方向ASC/DESC均可，因为是等值匹配）。如果索引把isDeleted放在第一个字段，哪怕方向正确也会失效。

• 等待索引完全生效
  Firebase创建复合索引需要1-5分钟的部署时间，刚创建完就测试会出现索引未就绪的情况，需等控制台索引状态显示「已启用」后再重试。

• 核对节点路径与数据类型

  1. 确认你创建索引的节点路径和代码中$ref指向的路径完全一致（比如$ref指向/articles，索引就必须建在articles节点下，不能是根节点或其他子节点）。
  2. 检查Firebase数据库中isDeleted字段的实际类型：如果存的是字符串"false"而非布尔值false，即使索引正确，查询也会因类型不匹配触发异常。

• 用自动生成链接创建索引
  若手动创建容易出错，可重新触发查询，复制报错信息里的索引链接，在浏览器中打开（确保已登录Firebase控制台），系统会自动帮你创建完全匹配查询逻辑的索引，避免手动配置错误。

代码层面再次确认查询逻辑：

// 确保$ref指向正确的节点
$ref = $database->getReference('你的目标节点路径');
$query = $ref->orderBy('date', 'DESC')->where("isDeleted", "=", false);

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