Firestore数组筛选查询始终返回空列表问题排查

核心问题 #

你当前的查询用 arrayContains: {'userID': 'gg'} 无法匹配数据，是因为Firestore的arrayContains要求数组中的元素与查询对象完全一致——也就是说，只有当participants数组里存在一个对象，其所有字段（比如你数据库里的userID和username等）都和你传入的{'userID': 'gg'}完全相同时，才会返回结果。而你的数据库里每个participants元素都包含多个字段，所以只传userID的对象无法匹配。

另外，创建participants.userID索引没用，因为arrayContains针对的是整个数组元素，而非元素内的单个字段。

解决方案 #

要实现“查询包含特定userID的聊天记录”，你需要调整数据结构，以下两种方案可选：

方案1：将participants改为纯userID数组 #

把participants字段从对象数组改成字符串数组，比如：

participants: ["gg", "other-user-id"]

之后用以下查询即可匹配：

_firestore
        .collection('chat')
        .where('participants', arrayContains: 'gg')
        .snapshots()

方案2：改用Map结构存储参与者ID #

新增一个participantIDs字段（或替换原participants），用Map存储，键为userID，值设为true：

participantIDs: {
  "gg": true,
  "other-user-id": true
}

之后用以下查询：

_firestore
        .collection('chat')
        .where('participantIDs.gg', isEqualTo: true)
        .snapshots()

这种方式的优势是可以同时查询多个用户（比如多人群聊），且性能稳定。

关于场景合理性 #

你当前的用法不属于Firestore arrayContains的合理场景，因为它不支持“匹配数组对象中单个字段”的查询逻辑。必须通过调整数据结构才能实现你的需求。

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