Flutter中如何正确Mock依赖的Cubit以测试Bloc？

1. 准备依赖 #

确保你的pubspec.yaml包含必要的测试依赖：

dev_dependencies:
  flutter_test:
    sdk: flutter
  mocktail: ^1.0.0 # 适配空安全的Mock工具，替代mockito
  bloc_test: ^9.1.0 # 可选，简化Bloc测试流程

2. 生成Mock类 #

用mocktail创建ViewItemCubit和ViewItemState的Mock实现：

import 'package:mocktail/mocktail.dart';
import 'package:your_project/cubits/view_item_cubit.dart';

class MockViewItemCubit extends Mock implements ViewItemCubit {}
class MockViewItemState extends Mock implements ViewItemState {}

3. 配置Mock行为与测试逻辑 #

在测试用例中，初始化Mock实例并预设状态，再关联到真实的AddItemBloc：

void main() {
  group('AddItemBloc', () {
    late MockViewItemCubit mockViewItemCubit;
    late AddItemBloc addItemBloc;
    // 预设测试用的viewItems列表
    final testViewItems = [ViewItem(id: '1', name: 'Test Item 1'), ViewItem(id: '2', name: 'Test Item 2')];

    setUp(() {
      mockViewItemCubit = MockViewItemCubit();
      
      // 1. 配置Mock的初始状态（根据业务逻辑调整）
      when(() => mockViewItemCubit.state).thenReturn(ViewItemState(viewItems: []));
      
      // 2. 配置调用fetchViewItems后的行为：更新state为包含预设数据的状态
      when(() => mockViewItemCubit.fetchViewItems()).thenAnswer((_) async {
        when(() => mockViewItemCubit.state).thenReturn(ViewItemState(viewItems: testViewItems));
      });

      // 3. 用Mock的ViewItemCubit初始化真实的AddItemBloc
      addItemBloc = AddItemBloc(viewItemCubit: mockViewItemCubit);
    });

    tearDown(() {
      addItemBloc.close();
      mockViewItemCubit.close();
    });

    testWidgets('成功获取预设viewItems列表', (tester) async {
      // 触发AddItemBloc中需要调用fetchViewItems的事件
      addItemBloc.add(LoadViewItemsEvent());

      // 等待UI和状态更新完成
      await tester.pumpAndSettle();

      // 验证fetchViewItems是否被正确调用
      verify(() => mockViewItemCubit.fetchViewItems()).called(1);

      // 验证AddItemBloc是否获取到了预设的viewItems
      expect(addItemBloc.state.viewItems, equals(testViewItems));
    });
  });
}

关键注意事项 #

• 状态可比较性：确保ViewItem和ViewItemState重写了==和hashCode，或者使用freezed生成不可变类，否则expect断言会失败。
• 状态更新模拟：如果ViewItemCubit的fetchViewItems是异步更新状态，要确保mock在调用后更新了state的返回值，或者使用mocktail的emit模拟（需配合cubit的mock扩展）。
• 依赖注入替换：如果项目用了依赖注入框架（如get_it），测试时要临时替换ViewItemCubit的注册实例为Mock对象。
• 监听逻辑验证：确认AddItemBloc中正确监听了ViewItemCubit的状态变化，比如在构造函数中添加viewItemCubit.stream.listen((state) => ...)逻辑。

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