Java单元测试中自动初始化模拟数据的核心是结合JUnit与Mockito，主流方式为MockitoExtension配合@Mock/@InjectMocks注解实现零配置注入，或通过@BeforeEach统一预设行为，亦可自定义注解+Extension封装数据模板。
Java 中利用注解在单元测试中自动初始化模拟数据，核心是结合测试框架（如 JUnit）与模拟库（如 Mockito），通过自定义或现成的注解 + 测试扩展机制实现“声明即生效”。主流方式是使用 MockitoExtension（JUnit 5）配合 @Mock、@InjectMocks 等标准注解，或通过 @TestInstance + 自定义注解 + Extension 实现更灵活的数据预置。
用 MockitoExtension + 标准注解快速注入模拟对象
这是最常用、零配置的方式。只需添加依赖并启用扩展，就能在测试类字段上用注解自动创建和注入模拟实例：
- 添加依赖（Maven）：
mockito-junit-jupiter（兼容 JUnit 5） - 在测试类上加
@ExtendWith(MockitoExtension.class)（JUnit 5.7+ 可省略，因已默认启用） - 用
@Mock声明需要模拟的对象（如UserService） - 用
@InjectMocks标记待测对象（如UserController），Mockito 会自动把 @Mock 字段按类型/名称注入进去
示例：
@ExtendWith(MockitoExtension.class)
class UserControllerTest {
@Mock
private UserService userService;
@InjectMocks
private UserController userController; // 自动注入 userService
@Test
void shouldReturnUserById() {
when(userService.findById(1L)).thenReturn(new User(1L, "Alice"));
assertEquals("Alice", userController.getUser(1L).getName());
}
}
用 @BeforeEach + 工具方法统一准备测试数据
当模拟逻辑较复杂（如多层返回、异常场景），单纯靠注解不够时，可在 @BeforeEach 中集中初始化，并结合注解字段复用：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 保留
@Mock字段声明，保证对象生命周期由 Mockito 管理 - 在
@BeforeEach方法里调用when(...).thenReturn(...)或doThrow(...)预设行为 - 支持按测试方法名或参数动态设置不同返回值（用
TestInfo注入）
这样既保持注解声明的简洁性，又赋予数据初始化充分的控制力。
自定义注解 + JUnit 5 Extension 实现“数据模板”
若团队有固定测试数据模式（如每次测试前都需插入 3 条用户 + 2 条订单），可封装成自定义注解，例如 @WithSampleData：
- 定义注解：
@Target(ElementType.METHOD)或TYPE，支持运行时保留 - 实现
ParameterResolver或BeforeEachCallback扩展类，在回调中解析注解并执行数据构造逻辑（如调用DataBuilder.createUsers(3)） - 注册扩展：测试类加
@ExtendWith(SampleDataExtension.class)
这种方式将“初始化什么数据”从代码逻辑中抽离为声明式配置，提升可读性和复用性。
注意事项与避坑点
实际使用中需注意几个关键细节：
-
@Mock和@Spy不可混用于同一字段；@Spy是对真实对象的部分模拟，需手动 new 出实例 - 字段必须是非 private（或用
@TestInstance(Lifecycle.PER_METHOD)配合反射访问），否则 Mockito 无法注入 - 避免在
@BeforeAll中初始化@Mock对象——它属于单例生命周期，会导致测试间状态污染 - 若使用 Spring Boot Test，优先考虑
@MockBean替代@Mock，确保 Bean 容器中被正确替换
