Flutter Equatable包处理带Z的UTC格式DateTime时相等判断失效

核心原因 #

你的问题本质是两个层面的问题叠加：

1. Dart DateTime的相等性规则：Dart中两个DateTime对象相等，必须同时满足三个条件：

   • 毫秒/微秒时间戳完全一致
   • isUtc属性相同（一个是UTC时间、一个是本地时间的话，即使显示时间相同，==也会返回false）
   • 高版本Dart中，纳秒数也需要完全一致
     你遇到的2024-01-01 22:00:00.000Z == 2024-01-01 22:00:00.000Z // false，大概率是两个DateTime的微秒/纳秒数存在差异，或者其中一个的isUtc属性为false（比如误把本地时间当成了UTC时间）。

2. ClockPair类的Equatable配置遗漏：你的ClockPair类定义了typeIn和typeOut字段，但props列表里没有包含这两个字段。如果测试用例中预期和实际对象的这两个字段值不同，即使其他字段完全一致，Equatable也会判定两个对象不相等——而你的测试输出没有展示这两个字段，很可能是toString方法没包含，但实际值存在差异。

解决步骤 #

1. 排查DateTime对象的实际差异 #

先打印出两个“看起来相同”的UTC DateTime的关键属性，确认差异点：

// 假设date1和date2是你要比较的两个时间对象
print(date1.microsecondsSinceEpoch);
print(date2.microsecondsSinceEpoch);
print(date1.isUtc);
print(date2.isUtc);
// Dart 2.19+ 还需要检查纳秒
print(date1.nanosecondsSinceEpoch);
print(date2.nanosecondsSinceEpoch);

如果这些值完全一致，==一定会返回true；如果有差异，就针对性修复（比如统一时间创建方式，避免微秒/纳秒不一致）。

2. 补全Equatable的props列表 #

如果typeIn和typeOut是ClockPair相等性判断的一部分，必须把它们加入props：

@override
List<Object?> get props => [
      userId,
      duration,
      clockIn,
      clockOut,
      typeIn, // 新增
      typeOut, // 新增
    ];

如果这两个字段不影响相等性，可以忽略，但要确保测试用例中它们的值完全一致。

3. 自定义时间比较逻辑（可选） #

如果需要忽略时区，只比较时间的实际值（比如本地时间和UTC时间只要对应的UTC时间值相同就视为相等），可以在props中转换为时间戳来比较：

@override
List<Object?> get props => [
      userId,
      duration,
      clockIn?.toUtc().microsecondsSinceEpoch,
      clockOut?.toUtc().microsecondsSinceEpoch,
      typeIn,
      typeOut,
    ];

这样不管时间对象是UTC还是本地时间，都会统一转成UTC的微秒数来比较，只要时间值相同就会被判定为相等。

4. 统一测试用例的时间创建方式 #

测试时尽量用同一种方式创建UTC时间，避免混合不同方法导致的隐性差异：

// 统一用parse创建UTC时间
final expectedClockIn = DateTime.parse("2024-01-01T22:00:00.000Z");
// 或者统一用utc构造函数
final expectedClockIn = DateTime.utc(2024, 1, 1, 22, 0, 0, 0, 0);

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