Flutter+Firebase日期范围查询异常：切换范围返回旧数据

核心问题点 #

1. StreamBuilder未响应日期范围变更
   如果firstDayOfWeek和lastDayOfWeek不是StatefulWidget的状态变量，或者更新时未调用setState()，StreamBuilder不会重建，始终订阅初始创建的数据流，自然不会返回新范围的查询结果。

2. UI更新逻辑错误
   你在StreamBuilder的builder回调中仅更新了外部变量registrationListDB，但未直接返回基于新数据构建的Widget。如果registrationListDB不是响应式状态（比如未使用State/Provider等状态管理），UI不会自动刷新，始终显示旧数据。

3. 日期范围查询的边界与时区问题

   • DateTime转Timestamp时未处理时区，Firestore的Timestamp默认使用UTC时间，本地时间直接转换可能导致查询范围偏移。
   • 使用isLessThanOrEqualTo可能会漏掉当天的部分数据，或者包含下一天的初始时刻数据，边界处理不准确。

具体修复步骤 #

1. 用状态管理控制日期范围

将日期范围设为StatefulWidget的状态变量，更新时通过setState()触发StreamBuilder重建：

class _RegistrationPageState extends State<RegistrationPage> {
  late DateTime _firstDayOfWeek;
  late DateTime _lastDayOfWeek;

  @override
  void initState() {
    super.initState();
    // 初始化默认周范围
    final now = DateTime.now();
    _firstDayOfWeek = DateTime(now.year, now.month, now.day - now.weekday + 1);
    _lastDayOfWeek = DateTime(now.year, now.month, now.day + (7 - now.weekday));
  }

  // 切换日期范围的方法
  void switchWeek(DateTime newFirst, DateTime newLast) {
    setState(() {
      _firstDayOfWeek = newFirst;
      _lastDayOfWeek = newLast;
    });
  }

  @override
  Widget build(BuildContext context) {
    return StreamBuilder<QuerySnapshot>(
      stream: DatabaseService().getRegistrationsByDateRange(_firstDayOfWeek, _lastDayOfWeek),
      builder: (context, snapshot) {
        // 处理快照状态
        if (snapshot.hasError) return const Center(child: Text('加载出错'));
        if (snapshot.connectionState == ConnectionState.waiting) return const Center(child: CircularProgressIndicator());
        
        if (snapshot.hasData) {
          Map<String, Registration> regMap = {};
          for (var doc in snapshot.data!.docs) {
            Registration result = Registration.fromQueryDocumentSnapshot(doc);
            regMap[doc.reference.id] = result;
          }
          regMap.removeWhere((key, value) => filterOnRegistrationDate(value));

          if (regMap.isEmpty) return const Center(child: Text('该周无记录'));
          
          // 直接在builder内处理数据并返回UI
          final gridList = _categoriseRegistration(regMap);
          // 这里替换为你实际的列表/网格UI组件
          return GridView.count(
            crossAxisCount: 7,
            children: _buildGridItems(gridList),
          );
        }
        
        return const SizedBox();
      },
    );
  }
}

2. 修正Firestore查询的日期处理

调整日期转Timestamp的逻辑，统一使用UTC时间，并修正范围边界：

Stream<QuerySnapshot<Map<String, dynamic>>> getRegistrationsByDateRange(DateTime firstDayOfWeek, DateTime lastDayOfWeek) {
  // 转换为UTC时间，避免时区差异
  final start = Timestamp.fromDate(firstDayOfWeek.toUtc());
  // 结束时间设为下一天的0点，用isLessThan确保包含整周的所有数据
  final end = Timestamp.fromDate(lastDayOfWeek.toUtc().add(const Duration(days: 1)));
  
  return FirebaseFirestore.instance
      .collection('Registration')
      .where('registrationDate', isGreaterThanOrEqualTo: start)
      .where('registrationDate', isLessThan: end)
      .snapshots();
}

3. 优化数据处理逻辑

不要用TextEditingController存储静态数据（这是用于输入控件的类），直接存储字符串，并简化日期解析：

Map<String, Map<DateTime, RegistrationUnit>> _categoriseRegistration(Map<String, Registration> regMap) {
  Map<String, Map<DateTime, RegistrationUnit>> gridList = {};
  
  regMap.forEach((docID, registration) {
    final regDate = registration.registrationDate.toDate();
    // 提取年月日作为唯一key，避免时分秒干扰
    final dateKey = DateTime(regDate.year, regDate.month, regDate.day);
    
    // 初始化当前项目的日期映射
    final projectMap = gridList.putIfAbsent(registration.projectID, () => {});
    
    projectMap[dateKey] = RegistrationUnit(
      docID: docID,
      projectID: registration.projectID,
      description: registration.descriptionText,
      hours: registration.registrationTime.toString(),
      registrationDate: dateKey,
    );
  });
  
  return gridList;
}

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