为何build_runner执行成功却无输出？Dio Mock生成失败排查

数据老陈

2026-7-1

Dio Mock生成失败的排查要点

以下是导致dart run build_runner build执行成功但未生成Mock文件的常见原因及对应解决方向：

注解放置位置错误
@GenerateMocks([Dio]) 必须放在测试文件的顶级作用域，不能嵌套在main函数、类或其他代码块内部。要确保注解直接写在文件开头、main()函数的上方，无任何缩进。
依赖配置缺失或不兼容
检查pubspec.yaml的dev_dependencies块，必须同时包含mockito和build_runner，示例配置：
```
dev_dependencies:
  mockito: ^5.4.0
  build_runner: ^2.4.4
```
仅添加build_runner无法触发Mock类生成，必须搭配mockito依赖。
测试文件命名不符合规则
build_runner默认仅处理文件名以_test.dart结尾的测试文件。如果你的测试文件名是xxx.dart而非xxx_test.dart，生成器会直接忽略该文件。
Dio类未正确导入
测试文件中必须显式导入Dio包：import 'package:dio/dio.dart';。若未导入，@GenerateMocks([Dio])中的Dio会被识别为未定义类型，生成器不会执行生成操作。
缓存干扰生成流程
旧的构建缓存可能导致生成器不触发新的生成任务，执行以下命令清理缓存后重新构建：
```
dart run build_runner clean
dart run build_runner build
```
生成路径被规则过滤
若项目根目录存在build.yaml文件，检查是否配置了排除规则，导致生成的Mock文件被过滤。默认Mock类会生成在test/.dart_tool/build/generated/目录下，确认该目录未被IDE或文件系统隐藏。
特殊类的Mock限制
极少数情况下，若Dio类存在无法被mockito处理的特性（如私有构造函数、不可继承的设计），可尝试替换为@GenerateNiceMocks([Dio])注解，或确认Dio类是否支持Mock继承。