使用arrayContains从Firestore获取顶级集合ID失败求助

使用Firestore的arrayContains查询聊天文档时始终返回0个文档，chatId一直为"newChat"，但用户ID确实存在于集合中；改用arrayContainsAny会返回与其他用户的聊天记录，需要获取带有子集合的顶级集合ID（对应图中蓝色下划线标记的ID）。

相关代码：

TextButton(
  onPressed: () async {
    await ServerAPI().chatsCollection
        .where('users', arrayContains: [FirebaseAuth.instance.currentUser!.uid,
      widget.outletId])
        .get().then((value) {
      setState(() {
         value.docs.isEmpty ?
         chatId = "newChat"
             : chatId = value.docs.first.id;
      });
      debugPrint('${widget.outletId}, ${chatId}');
    });
      Get.to(() => ChatScreen(chatId: chatId, senderId: FirebaseAuth.instance.currentUser!.uid,
    receiverId: widget.outletId));
  },
)

核心问题 #

Firestore的arrayContains是完全匹配数组的顺序和内容，你当前查询的数组是[当前用户UID, outletId]，但文档中users数组的顺序可能是反过来的（比如[outletId, 当前用户UID]），导致无法匹配到目标文档。

解决办法 #

方法1：统一数组排序规则（推荐）

存储和查询时都对用户ID数组按字典序排序，确保顺序一致：

// 存储聊天文档时先排序
final currentUid = FirebaseAuth.instance.currentUser!.uid;
List<String> sortedUsers = [currentUid, widget.outletId]..sort();
await ServerAPI().chatsCollection.add({
  'users': sortedUsers,
  // 其他聊天字段
});

// 查询时同样排序
onPressed: () async {
  final currentUid = FirebaseAuth.instance.currentUser!.uid;
  List<String> queryUsers = [currentUid, widget.outletId]..sort();
  
  final snapshot = await ServerAPI().chatsCollection
      .where('users', arrayContains: queryUsers)
      .get();
  
  setState(() {
    chatId = snapshot.docs.isEmpty ? "newChat" : snapshot.docs.first.id;
  });
  debugPrint('${widget.outletId}, ${chatId}');
  Get.to(() => ChatScreen(
    chatId: chatId,
    senderId: currentUid,
    receiverId: widget.outletId,
  ));
},

方法2：改用映射结构存储用户关系（更灵活）

将users字段改为键值对形式（键为用户UID，值为true），这样查询不受顺序影响，还能支持多用户聊天场景：

// 存储聊天文档
await ServerAPI().chatsCollection.add({
  'users': {
    FirebaseAuth.instance.currentUser!.uid: true,
    widget.outletId: true
  },
  // 其他聊天字段
});

// 查询时使用复合条件
onPressed: () async {
  final currentUid = FirebaseAuth.instance.currentUser!.uid;
  
  final snapshot = await ServerAPI().chatsCollection
      .where('users.${currentUid}', isEqualTo: true)
      .where('users.${widget.outletId}', isEqualTo: true)
      .get();
  
  setState(() {
    chatId = snapshot.docs.isEmpty ? "newChat" : snapshot.docs.first.id;
  });
  debugPrint('${widget.outletId}, ${chatId}');
  Get.to(() => ChatScreen(
    chatId: chatId,
    senderId: currentUid,
    receiverId: widget.outletId,
  ));
},

注意：使用复合查询时需要在Firestore控制台创建对应的复合索引，否则会收到索引缺失的错误提示，按照提示创建即可。

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