Mockito@GenerateMocks报错：类已内联模拟，求解决方案

问题重现 #

执行flutter pub run build_runner build时触发错误：

Invalid @GenerateMocks annotation: The GenerateMocks annotation contains a class which appears to already be mocked inline: MockRemoteDataSource; use the 'customMocks' argument in @GenerateMocks to specify a unique name.

你的代码同时存在手动定义的Mock类和@GenerateMocks注解，两者的命名逻辑引发了冲突。

错误原因 #

1. 手动定义了MockRemoteDataSource、MockLocalDataSource、MockNetworkInfo三个Mock类，直接继承Mock并实现对应接口。
2. 同时使用@GenerateMocks注解生成Mock类，Mockito默认生成的类名规则为Mock+原类名（如MockCleaningJobRemoteDataSource），但你的手动Mock类名与自动生成的命名逻辑产生冲突，或跨文件存在同名Mock类。
3. 从main函数里的MockMockRemoteDataSource这类错误变量名能看出，你已混淆手动Mock与自动生成Mock的命名规则，进一步加剧了问题。

解决步骤 #

方案一：移除手动Mock类，完全使用自动生成（推荐） #

这是符合新版本Mockito规范的最优方式：

1. 删除所有手动定义的Mock类：

// 删掉以下三行
class MockRemoteDataSource extends Mock implements CleaningJobRemoteDataSource {}
class MockLocalDataSource extends Mock implements CleaningJobLocalDataSource {}
class MockNetworkInfo extends Mock implements NetworkInfo {}

2. 合并@GenerateMocks注解（可选，更简洁）：

@GenerateMocks([
  CleaningJobRemoteDataSource,
  CleaningJobLocalDataSource,
  NetworkInfo
])

3. 修正main函数中的变量类型，使用自动生成的标准类名：

void main() {
  late final CleaningJobRepositoryImpl repository;
  late final MockCleaningJobRemoteDataSource mockRemoteDataSource;
  late final MockCleaningJobLocalDataSource mockLocalDataSource;
  late final MockNetworkInfo mockNetworkInfo;
  // 后续初始化逻辑...
}

4. 重新执行flutter pub run build_runner build生成Mock类。

方案二：保留手动Mock，调整自动生成类名 #

若需保留手动Mock类，通过customMocks参数指定自动生成类的唯一名称：

// 保留手动定义的Mock类
class MockRemoteDataSource extends Mock implements CleaningJobRemoteDataSource {}
class MockLocalDataSource extends Mock implements CleaningJobLocalDataSource {}
class MockNetworkInfo extends Mock implements NetworkInfo {}

// 使用customMocks指定不同的生成类名
@GenerateMocks([], customMocks: [
  MockSpec<CleaningJobRemoteDataSource>(as: #AutoMockRemoteDataSource),
  MockSpec<CleaningJobLocalDataSource>(as: #AutoMockLocalDataSource),
  MockSpec<NetworkInfo>(as: #AutoMockNetworkInfo),
])

随后在代码中使用指定的类名：

void main() {
  late final CleaningJobRepositoryImpl repository;
  late final AutoMockRemoteDataSource mockRemoteDataSource;
  // 其他变量同理...
}

额外注意事项 #

• 确保所有测试文件中的Mock类命名不重复，避免跨文件命名冲突。
• 新版本Mockito优先推荐自动生成Mock类，可减少手动维护成本，从根源避免这类冲突问题。

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