Firestore中FieldPath.documentId与OR过滤器组合查询结果异常

当userCollection中仅存在一个ID为myUid的文档时，执行以下函数预期返回0条结果（排除myUid对应的文档），但实际却检索到了该文档，结果数量为1：

static Future<String?> getUnmatchedUser(String? myUid) async{   
  print('getUnmatchedUser: myUid == $myUid');

  try {
      QuerySnapshot querySnapshot = await _userCollection
                                      .where(FieldPath.documentId, isNotEqualTo: myUid)
                                      .where(Filter.or(
                                        Filter("queried_language", isEqualTo: 'en'),
                                        Filter("queried_language", isEqualTo: 'ja')))
                                      .get();

      print('querySnapshot.docs.length == ${querySnapshot.docs.length}');
          return null;
            
  } catch (e) {
      print('getUnmatchedUser: ERROR == $e');
      return null;
  }
}     

但移除包含OR过滤器的where语句后，查询结果符合预期（返回0条）：

QuerySnapshot querySnapshot = await _userCollection
                                .where(FieldPath.documentId, isNotEqualTo: myUid)
                                .get();

核心原因 #

问题出在范围条件与OR过滤器的组合查询逻辑：

• FieldPath.documentId, isNotEqualTo: myUid属于范围类条件，而你用Filter.or针对同一字段设置了多个相等条件，这种组合需要Firestore的复合索引支持才能正确执行。
• 如果缺少对应的复合索引，Firestore无法正确解析并应用所有过滤条件，导致documentId != myUid的规则被忽略，最终返回了本该被排除的文档。
• 另外，若该文档的queried_language字段恰好是en或ja，会进一步触发这个异常结果。

解决办法 #

1. 简化OR过滤器为whereIn
   针对同一字段的多值相等匹配，用whereIn替代Filter.or，逻辑更简洁且Firestore能更稳定地处理：

   QuerySnapshot querySnapshot = await _userCollection
       .where(FieldPath.documentId, isNotEqualTo: myUid)
       .where("queried_language", whereIn: ['en', 'ja'])
       .get();
   

2. 创建复合索引
   如果使用whereIn后问题仍存在，需在Firestore控制台创建对应的复合索引：

   • 目标集合：userCollection
   • 索引字段：documentId（排序方向任选） + queried_language（排序方向任选）

3. 基础验证

   • 确认myUid的值与目标文档ID完全一致（注意大小写、空格等细节）
   • 检查该文档的queried_language字段值是否确实不符合en/ja的预期（若不该匹配的话）

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