Flutter测试异常：同类型对象runtimeType比较返回false问题

核心问题 #

你遇到的是Mockito参数匹配时的类型校验异常：尽管WorkflowButtonClicked继承了Equatable，且实际调用和验证代码中的实例属性一致、runtimeType字符串相同，但runtimeType == other.runtimeType返回false，导致verify断言失败。重写runtimeType返回类本身无效，返回基础类型（如"int"）正常，这说明测试环境中存在类加载隔离问题，同一个类的Type实例被视为不同对象。

解决方案 #

方案1：用Equatable的相等性实现自定义参数匹配（推荐） #

既然WorkflowButtonClicked已经继承Equatable并正确重写了==和hashCode，直接用argThat(equals(...))来匹配参数，绕过runtimeType的校验：

verify(logger.i(argThat(equals(WorkflowButtonClicked(value: true))))).called(1);

这个方式会直接使用Equatable的==逻辑比较实例，不需要依赖Type对象的相等性。

方案2：修复类加载的根源问题 #

如果必须依赖默认的参数匹配逻辑，需要排查类加载隔离的可能原因：

• 检查测试文件的导入路径，确保生产代码中的WorkflowButtonClicked和测试代码导入的是同一个文件，避免相对路径错误或重复导入不同版本的类。
• 清理项目缓存：执行flutter clean（Flutter项目）或dart clean（纯Dart项目），然后重新运行测试，清除旧编译产物导致的类隔离。
• 若使用了代码生成工具（如build_runner），执行flutter pub run build_runner clean再重新生成代码，确保生成文件是最新的。

方案3：自定义匹配器忽略Type对象，只校验类型字符串和属性 #

如果上述方案都不适用，可以手动写一个匹配器，只检查类型字符串和实例属性：

// 自定义匹配器
Matcher matchesWorkflowButtonClicked(bool expectedValue) => predicate((dynamic arg) {
  return arg is WorkflowButtonClicked &&
         arg.value == expectedValue &&
         arg.runtimeType.toString() == WorkflowButtonClicked.toString();
});

// 验证时使用
verify(logger.i(argThat(matchesWorkflowButtonClicked(true)))).called(1);

原因分析 #

Dart中的runtimeType是一个Type对象，即使两个类的名称完全一致，只要它们被加载到不同的库隔离或编译单元中，Type实例就不相等。在测试场景中，Mockito的字节码操作、热重载残留、旧编译缓存都可能导致同一个类被加载为不同的Type实例，进而导致类型比较失败。

内容的提问来源于stack exchange，提问作者Itai.S.