Flutter中如何实现Firebase Firestore多字段条件过滤查询

核心规则提前说明 #

Firestore复合查询存在固定限制：

• 等值匹配类条件（如where('manufacturing', isEqualTo: xxx)）必须全部放在范围查询类条件（如价格区间的isGreaterThan、isLessThan）之前
• 单次查询仅支持对1个字段执行范围查询，多字段范围查询需要拿到单范围查询结果后在本地做二次过滤
• 涉及多字段的复合查询必须提前创建对应顺序的复合索引

功能实现代码示例 #

基于cloud_firestore官方SDK的实现代码如下：

import 'package:cloud_firestore/cloud_firestore.dart';

/// 车辆筛选方法
/// [targetManufacturing] 目标生产厂商
/// [minPrice] 价格下限
/// [maxPrice] 价格上限
Future<List<Map<String, dynamic>>> getFilteredVehicles({
  required String targetManufacturing,
  required num minPrice,
  required num maxPrice,
}) async {
  // 1. 初始化集合引用
  final vehicleCollection = FirebaseFirestore.instance.collection('vehicles');
  // 2. 按优先级拼接查询条件：先等值，后范围
  final query = vehicleCollection
      .where('manufacturing', isEqualTo: targetManufacturing)
      .where('price', isGreaterThanOrEqualTo: minPrice)
      .where('price', isLessThanOrEqualTo: maxPrice);
  // 3. 执行查询
  final querySnapshot = await query.get();
  // 4. 转换数据格式返回
  return querySnapshot.docs.map((doc) => doc.data()).toList();
}

复合索引配置方法 #

第一次执行上述代码时会触发报错，报错日志中会自动生成对应复合索引的创建跳转链接，点击链接进入Firebase控制台后直接确认创建即可，索引创建耗时通常为1-2分钟，创建完成后即可正常返回筛选结果。

多条件扩展注意事项 #

• 如需增加其他等值筛选条件（如车型、颜色等），直接在范围查询条件之前新增where等值匹配语句即可，同时按照报错提示更新对应复合索引
• 若筛选参数为可选（如用户可以不指定生产厂商仅筛选价格区间），需要根据实际传入的参数动态构造查询语句，并适配对应场景的复合索引
• 如需对生产时间、行驶里程等多个字段做范围筛选，先选择数据过滤比例最高的字段做Firestore端的范围查询，其余范围条件在本地对返回结果做二次过滤即可

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