Flutter基于Firebase快照创建Map合并同key数据及报错解决

• 最初使用Map.fromIterable的方案天然不支持同key值合并，遇到重复日期时后面的条目会直接覆盖前面的，完全没法实现同日期事件聚合到同一个列表的需求。
• 后续改用groupBy时报The method 'toDate' was called on null错误，核心原因是Firebase返回的bookings列表中存在缺失date字段/date字段值为null的脏数据，没有做空值兜底就直接调用toDate()方法导致抛错。

先引入需要的依赖包：

import 'package:collection/collection.dart'; // 提供groupBy分组方法
import 'package:table_calendar/table_calendar.dart'; // 提供isSameDay、getHashCode日历工具方法

完整的事件转换逻辑如下，直接替换原有代码即可：

/// 将Firebase返回的booking列表转换为table_calendar可用的事件Map
LinkedHashMap<DateTime, List<dynamic>> convertToCalendarEvents(List<dynamic> bookings) {
  // 1. 过滤无效脏数据：排除date字段为空的条目，从源头避免空指针
  final validBookings = bookings.where((item) {
    final bookingMap = item as Map?;
    return bookingMap != null && bookingMap['date'] != null;
  }).toList();

  // 2. 按日期分组，做类型兼容+日期归一化处理
  final groupedMap = groupBy(validBookings, (obj) {
    final rawDate = (obj as Map)['date'];
    DateTime dateTime;
    // 兼容两种数据格式：Timestamp类型调用toDate，已经是DateTime类型直接使用
    if (rawDate is DateTime) {
      dateTime = rawDate;
    } else {
      dateTime = rawDate.toDate();
    }
    // 日期归一化：仅保留年月日，时分秒统一置0，避免同天不同时间被判定为不同key
    return DateTime(dateTime.year, dateTime.month, dateTime.day);
  });

  // 3. 构造table_calendar要求的LinkedHashMap结构
  final kEvents = LinkedHashMap<DateTime, List<dynamic>>(
    equals: isSameDay,
    hashCode: getHashCode,
  )..addAll(groupedMap);

  return kEvents;
}

/// 日历组件取指定日期事件时直接调用该方法
List<dynamic> getEventsForDay(DateTime day, LinkedHashMap<DateTime, List<dynamic>> events) {
  return events[day] ?? [];
}

• 不要在遍历的时候直接调用item.remove('date')，这个操作会修改Firebase返回的原始数据对象，后续其他地方用到原始booking数据时会出现字段缺失问题。如果不需要返回值里保留date字段，可以新建Map拷贝后再移除字段，不要直接修改原对象。
• 日期归一化是必须步骤：Firebase存储的Timestamp默认带有时分秒，哪怕是同一天，直接转DateTime后hashCode也不相等，会出现同天事件匹配不到、日历不显示标记的问题。
• 上面的代码已经做了类型兼容，不管date字段是Firebase的Timestamp类型还是普通DateTime类型都可以正常处理，不会触发类型转换错误。
• 如果你需要生成最开始示例中以'26 Jun'这类字符串为key的Map，只需要把分组时的key替换为DateFormat('dd MMM').format(dateTime)即可，注意需要提前引入intl包做日期格式化。

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