Flutter中Firebase Firestore如何用where查询嵌套数组匹配邮箱的文档

情况1：team_list为单对象（非数组） #

如果你的文档中team_list是单个对象，下属的team_member_list是存储邮箱的数组，直接使用Firestore的嵌套字段点语法配合arrayContains查询即可：

final String currentUserEmail = "你的邮箱地址";
final query = FirebaseFirestore.instance
    .collection('decision')
    // 嵌套字段用.连接层级，匹配数组中是否存在指定值
    .where("team_list.team_member_list", arrayContains: currentUserEmail)
    .orderBy('close_date');

情况2：team_list本身是数组 #

如果team_list是数组，数组内的每一项才包含team_member_list子数组，Firestore原生不支持直接查询嵌套层级的数组内容，需要提前做数据结构冗余：

1. 写入/更新decision文档时，新增一个顶层数组字段all_team_members，把team_list下所有team_member_list的邮箱全部平铺存入该字段
2. 直接查询该冗余字段即可：

final String currentUserEmail = "你的邮箱地址";
final query = FirebaseFirestore.instance
    .collection('decision')
    .where("all_team_members", arrayContains: currentUserEmail)
    .orderBy('close_date');

注意事项 #

• 同时使用where筛选和orderBy排序时，需要在Firestore控制台创建对应复合索引，首次运行代码如果触发索引缺失报错，直接使用报错提示的索引创建入口，等待创建完成即可正常使用
• 采用冗余字段方案时，每次修改team_list或team_member_list内容时，需要同步更新all_team_members的值，保证数据一致性

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