Flutter开发日期范围筛选时，空值调用isBefore触发NoSuchMethodError

该异常无复杂诱因，本质是代码链路中任意一个参与日期比对的DateTime实例为null，未经过空值校验就直接调用isBefore/isAfter方法触发的。按以下顺序逐节点排查即可快速定位根因：

• Transaction实体类fromJson的日期解析漏判空
  这是最高发的触发场景：
  • 若在fromJson中直接写DateTime.parse(json['date'])，一旦接口返回的JSON中日期字段缺失、字段名和后端约定不匹配（比如后端返回trade_time、tradeTime，代码取的是date）、字段值为null，解析流程会直接拿到空值，给Transaction实例的日期属性赋上null。
  • 排查方法：在fromJson的日期赋值行加打印日志，逐行确认解析结果：
    debugPrint('接口原始日期值: ${json['date']}, 解析后结果: ${DateTime.tryParse(json['date']?.toString() ?? '')}')
    只要看到打印的解析结果为null，即可确认是JSON解析环节的问题。
  • 修复方式：替换裸的DateTime.parse为带容错的解析逻辑，禁止把null值传递到后续流程：
    final rawDate = json['date']; DateTime? tradeDate = rawDate == null ? null : DateTime.tryParse(rawDate.toString());
• BudgetDateRangePicker的日期值初始化时序问题
  第二高频触发场景：
  若DateRangePicker的State中定义的开始/结束日期变量是可空类型，初始未赋值（比如DateTime? startDate, endDate;），且筛选逻辑没有等用户完成选择就提前执行，会直接拿未初始化的null值进入日期比对逻辑。
  • 排查方法：在筛选逻辑的入口处打印当前选中的区间值：
    debugPrint('当前选中期值: 开始=$startDate, 结束=$endDate')
    看到打印值为null，即可确认是选择器的状态传递问题。
  • 修复方式：给开始/结束日期设置合法的非空初始值（比如默认取当前自然月1号到当日），从根源避免null值进入比对链路；同时在比对逻辑最前置增加空值拦截，只要区间值任意一个为null，直接跳过筛选流程。
• FutureBuilder异步加载的时序错配
  第三类隐藏触发场景：
  TabBarView内嵌的FutureBuilder是异步加载流程，如果把筛选逻辑写在了builder的通用分支里，会在snapshot还未拿到接口数据（snapshot.data == null）、交易列表未完全初始化的时候，提前执行遍历比对循环，拿到空的交易对象、读取到null的日期属性后触发异常。
  • 排查方法：在遍历交易记录的循环入口加日志，打印当前正在比对的Transaction实例，一旦发现交易对象为空、日期属性为空，即可确认是时序问题。
  • 修复方式：把筛选逻辑的执行入口绑定在snapshot.hasData == true的分支下，只有等接口数据完全拉取、所有交易记录解析完成后，再触发日期比对流程。

可直接复用的带容错的筛选比对逻辑 #

所有日期比对前先做全链路空值校验，同时截断到日级别避免时分秒导致的边界筛选偏差：

bool filterByDateRange(Transaction tx, DateTime rangeStart, DateTime rangeEnd) {
  // 前置空值拦截，阻断null流到isBefore调用
  if (tx.tradeDate == null) return false;
  // 统一截断到日维度，消除时分秒的干扰
  final txDay = DateTime(tx.tradeDate!.year, tx.tradeDate!.month, tx.tradeDate!.day);
  final startDay = DateTime(rangeStart.year, rangeStart.month, rangeStart.day);
  final endDay = DateTime(rangeEnd.year, rangeEnd.month, rangeEnd.day);
  // 区间包含首尾边界
  return (txDay.isAfter(startDay) || txDay == startDay) && 
         (txDay.isBefore(endDay) || txDay == endDay);
}

排查过程中不要跳过逐行日志打印步骤，这类null空值异常是最容易定位的问题，不需要复杂的调试工具，只要顺着日期从接口到筛选逻辑的传递链路逐节点检查值是否为null即可。

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