Flutter中Firestore文档含Map值时where子句的正确用法

问题根源 #

你用方括号[]访问Firestore中participants Map的键，但Firestore的字段路径不允许包含[或]这类字符，这就是报错的直接原因。正确访问嵌套Map字段的方式是使用点符号。

修正后的查询代码 #

把where子句里的方括号替换成点号，即可正确查询嵌套Map中的键值对：

Future<ChatroomModel?> getChatroom(UserModel targetUser) async {
  final currentUserId = widget.usermodel.userid;
  final targetUserId = targetUser.userid;

  // 使用点符号访问嵌套Map的键
  QuerySnapshot querySnapshot = await FirebaseFirestore.instance
      .collection('chatrooms')
      .where("participants.$currentUserId", isEqualTo: true)
      .where("participants.$targetUserId", isEqualTo: true)
      .get();

  if (querySnapshot.docs.isNotEmpty) {
    // 将查询到的文档转换为ChatroomModel并返回
    return ChatroomModel.fromMap(querySnapshot.docs.first.data() as Map<String, dynamic>);
  } else {
    // 生成唯一聊天室ID（按字典序拼接，避免重复创建）
    List<String> ids = [currentUserId, targetUserId];
    ids.sort();
    String chatroomId = ids.join('_');

    // 创建新聊天室文档
    ChatroomModel newChatroom = ChatroomModel(
      chatroomid: chatroomId,
      participants: {
        currentUserId: true,
        targetUserId: true,
      },
      lastmessage: "",
    );

    await FirebaseFirestore.instance
        .collection('chatrooms')
        .doc(chatroomId)
        .set(newChatroom.toMap());

    return newChatroom;
  }
}

优化方案：直接通过聊天室ID查询 #

上面的方式需要两次where查询，其实可以通过预先生成唯一聊天室ID的方式直接查询文档是否存在，效率更高：

Future<ChatroomModel?> getChatroom(UserModel targetUser) async {
  final currentUserId = widget.usermodel.userid;
  final targetUserId = targetUser.userid;

  // 按字典序排序后拼接ID，确保两个用户的聊天室ID唯一且一致
  List<String> ids = [currentUserId, targetUserId];
  ids.sort();
  String chatroomId = ids.join('_');

  DocumentSnapshot docSnapshot = await FirebaseFirestore.instance
      .collection('chatrooms')
      .doc(chatroomId)
      .get();

  if (docSnapshot.exists) {
    return ChatroomModel.fromMap(docSnapshot.data() as Map<String, dynamic>);
  } else {
    ChatroomModel newChatroom = ChatroomModel(
      chatroomid: chatroomId,
      participants: {
        currentUserId: true,
        targetUserId: true,
      },
      lastmessage: "",
    );

    await FirebaseFirestore.instance
        .collection('chatrooms')
        .doc(chatroomId)
        .set(newChatroom.toMap());

    return newChatroom;
  }
}

关键说明 #

• Firestore中访问嵌套Map的字段路径格式为父字段.子键，比如participants.user123对应Map中user123键的值。
• 按字典序拼接用户ID生成聊天室ID，能保证无论哪个用户发起聊天，都会指向同一个聊天室，避免重复创建。

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