Flutter bloc_test测试报错：类型'Null'不是Future<List<Merchant>>的子类型
2026-10-9
问题排查&修复方案
1. 核心错误：Mockito空安全版本未生成合法Mock实现
你当前手动定义MockMerchantRepository继承Mock的方式，不适配空安全版本的Mockito（v5及以上）。未通过注解生成的Mock类的所有方法默认返回Null，而你的fetchMerchants方法声明返回非空的Future<List<Merchant>>，类型不匹配就会抛出这个错误。
修复步骤：
- 在测试文件顶部添加注解：
@GenerateMocks([MerchantRepository]) - 执行命令生成mock代码：
flutter pub run build_runner build - 删除你手写的
class MockMerchantRepository extends Mock implements MerchantRepository {}，直接使用生成的MockMerchantRepository即可。
2. 桩逻辑和测试期望冲突
你当前测试期望的是接口返回成功数据的状态GetMerchantsListState(merchantList)，但你给fetchMerchants打的桩是thenThrow(NetworkError())，会触发网络错误逻辑，完全匹配不上期望结果。
如果测成功场景，将桩代码替换为：
when(mockMerchantRepository.fetchMerchants(1)).thenAnswer((_) async => merchantList);
如果测错误场景，将expect的状态列表替换为对应的加载状态+错误状态即可。
3. 潜在的参数匹配问题
如果bloc调用fetchMerchants时传入的参数不是精确的1，会导致桩规则未命中，方法返回Null报错。不确定参数的情况下可以用any匹配任意参数：
when(mockMerchantRepository.fetchMerchants(any)).thenAnswer((_) async => merchantList);
内容的提问来源于stack exchange，提问作者karmous
相关产品推荐
相关产品推荐
