求助：Flutter代码覆盖率无法展示已覆盖函数，函数前显示0

常见原因及修复方案 #

• 确保测试真正执行了目标函数
  有时候Mockito的verify仅验证依赖调用，但实际测试未触发控制器的目标方法。检查测试代码是否真的执行了要覆盖的函数，比如：

  // 示例：先执行控制器方法，再验证依赖调用
  await controller.fetchData();
  verify(mockRepository.getData()).called(1);
  

  必须先触发控制器的目标方法，而非仅验证依赖的调用行为。

• 检查Mockito生成配置
  若使用@GenerateMocks时设置了mockMethodCalls: false，会导致Mockito不记录方法调用，影响覆盖率统计。确保生成Mock时使用默认配置，或显式开启该参数：

  @GenerateMocks([YourRepository], mockMethodCalls: true)
  

• 确认覆盖率命令与报告处理逻辑
  生成覆盖率的命令需包含目标代码文件，避免被错误过滤：

  # 生成原始覆盖率数据
  flutter test --coverage
  # 清理报告时排除自动生成的Mock文件，保留控制器代码
  lcov --remove coverage/lcov.info 'lib/**/*.g.dart' 'lib/**/*.mock.dart' -o coverage/cleaned_lcov.info
  # 生成HTML报告
  genhtml coverage/cleaned_lcov.info -o coverage/html
  

  注意不要误将控制器所在文件从报告中移除。

• 避免Mock控制器本身
  若测试中Mock了控制器实例而非依赖，真实控制器代码不会被执行，自然无覆盖率。正确做法是测试真实控制器实例，仅Mock它的依赖：
  ❌ 错误示例：

  final mockController = MockYourController();
  test('test case', () {
    verify(mockController.someMethod()).called(1);
  });
  

  ✅ 正确示例：

  final realController = YourController(mockRepository);
  test('test case', () async {
    await realController.someMethod();
    verify(mockRepository.someCall()).called(1);
  });
  

• 更新依赖版本
  旧版本Mockito或Flutter测试框架可能存在覆盖率统计bug，尝试更新pubspec.yaml中的依赖：

  dev_dependencies:
    mockito: ^5.4.0 # 使用最新稳定版
    flutter_test:
      sdk: flutter
    test: ^1.24.0
  

  执行flutter pub get后重新运行测试与覆盖率生成。

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