Flutter中Firestore多不等式过滤报错，如何查询日期区间文档？

错误原因 #

Firestore有两个核心限制导致这个报错：

1. 多字段不等式限制：默认不允许对不同字段同时使用>=/<=这类不等式过滤，除非创建对应的复合索引。
2. 日期存储格式错误：你用字符串存储日期，字符串比较是按字典序执行的（比如'21-05-2023'会被判定为比'01-06-2023'大），完全不符合日期的实际逻辑，这会导致查询结果彻底错误。

分步解决方案 #

1. 修正日期存储类型

先把Firestore文档里的sem_start_date和sem_end_date字段改成Timestamp类型（Flutter中直接存储DateTime对象即可，Firestore会自动转换为Timestamp）。如果是旧数据，需要批量更新现有文档的日期字段格式。

2. 调整查询代码

将字符串日期转为DateTime对象，再执行查询：

getTestFeeStructure() async {
  feeTestModelList.clear();
  feeTestNameList.clear();
  
  // 把目标日期转为DateTime类型
  DateTime targetDate = DateTime(2023, 5, 21);

  try {
    QuerySnapshot querySnapshot = await FirebaseFirestore.instance
        .collection('feeStructureTest')
        .where('sem_start_date', isGreaterThanOrEqualTo: targetDate)
        .where('sem_end_date', isLessThanOrEqualTo: targetDate)
        .get();

    for (var doc in querySnapshot.docs) {
      FeeTestModel feeModel = FeeTestModel(
        documentId: doc.id,
        feeName: doc["fee_name"],
        amount: doc["amount"],
        academicYear: doc["academic_year"],
        courseName: doc["course_name"],
        customFeeName: doc["custom_fee_name"],
        semId: doc["sem_id"],
        semStartDate: (doc["sem_start_date"] as Timestamp).toDate(), // 转成DateTime
        semEndDate: (doc["sem_end_date"] as Timestamp).toDate(),
      );
      feeTestModelList.add(feeModel);
      feeTestNameList.add(feeModel.feeName);
    }
  } catch (e) {
    // 捕获错误，比如索引缺失的情况
    if (e.toString().contains('复合索引')) {
      // 此时控制台会打印一个链接，点击即可自动创建所需的复合索引
      print('请点击控制台中的链接创建复合索引: $e');
    } else {
      print('查询出错: $e');
    }
  } finally {
    isLoading = false;
    update();
  }
}

3. 创建复合索引

第一次执行修正后的查询时，Firestore会抛出包含索引创建链接的错误。直接复制链接到浏览器打开，按照提示点击创建即可，无需手动配置索引参数。

额外说明 #

如果你的实际需求是查找目标日期处于学期时间段内的文档（即sem_start_date <= 目标日期 <= sem_end_date），只需调整查询条件：

.where('sem_start_date', isLessThanOrEqualTo: targetDate)
.where('sem_end_date', isGreaterThanOrEqualTo: targetDate)

同样需要创建对应的复合索引，步骤和上面一致。

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