Firestore OR查询无结果及排序与过滤属性不匹配问题解析

问题背景 #

配置的Firestore规则 #

allow read: if ('liveOn' in resource.data || request.auth.uid == artistId);
  // 我也试过用resource.id代替artistId
  allow write: if false;
}```

### 使用的查询代码
```const [unsortedArtists = [], loading, error] = useCollectionData(
  query(
      artistsCollection,
          or(
            where("liveOn", "!=", null),
            where(documentId(), "==", auth.uid)
          )
    )
);```

### 遇到的问题
单独注释掉任意一个`where`子句，都能返回对应文档，但组合成`or`查询后完全没有结果，预期应该是两个子句结果的并集。

### 补充的隐藏错误
> FirebaseError: inequality filter property and first sort order must be the same: `__name__` and `liveOn`

---

## 问题分析
### 1. 错误信息的含义
Firestore的`or`查询有严格的索引要求：如果其中一个子查询用了不等过滤（比如`!=`、`<`、`>`这类），所有子查询的排序字段必须和这个不等过滤的字段保持一致。你这里用了`liveOn != null`（属于不等过滤），同时另一个子查询基于文档ID（`__name__`）做匹配，Firestore会默认对文档ID做隐式排序，导致和不等过滤的`liveOn`字段冲突，直接触发这个报错，查询根本没执行成功，所以没返回结果。

### 2. 安全规则与查询的逻辑冲突
你之前理解的“OR查询每个子句单独校验规则”是错的，Firestore的安全规则是对**整个查询返回的所有文档**做校验，要求每个文档都满足规则里的`('liveOn' in resource.data || request.auth.uid == artistId)`。但核心问题是：Firestore不支持跨不同字段的`or`查询——你的两个子查询一个基于`liveOn`，一个基于文档ID，这两个字段无法共用同一个复合索引，导致查询无法命中有效索引，直接被拦截。

---

## 正确的实现方式
### 方案一：拆分查询，客户端合并结果
既然单个子查询都能正常工作，直接发起两个独立查询，在客户端合并并去重：
```javascript
// 查询所有liveOn不为null的艺术家
const [liveArtists] = useCollectionData(query(artistsCollection, where("liveOn", "!=", null)));
// 查询当前用户自己的艺术家文档
const [userArtist] = useCollectionData(query(artistsCollection, where(documentId(), "==", auth.uid)));

// 合并两个结果并去重（用文档ID作为唯一标识）
const combinedArtists = [...new Map(
  [...(liveArtists || []), ...(userArtist || [])].map(item => [item.id, item])
).values()];

方案二：调整数据结构，新增统一过滤字段 #

给每个artists文档添加一个isVisible字段，当liveOn存在或者文档ID等于用户UID时，设置isVisible: true。之后直接查询：

query(artistsCollection, where("isVisible", "==", true))

注意：如果当前规则禁止写入，需要通过云函数批量更新现有文档的isVisible字段，后续新文档写入时也要维护这个字段。

方案三：保留规则，分场景查询 #

如果业务上可以接受分场景展示（比如先展示用户自己的文档，再展示live的文档），可以直接保留两个独立查询，分别渲染结果，不需要合并。

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