在 Spring Boot 的 Mockito 单元测试中，@Value 注入的配置属性（如 aws.s3.bucketName）为 null，根本原因是 Spring 容器未启动、配置文件未加载；解决方法是使用 @SpringBootTest 启动最小上下文，并配合 @TestConfiguration 或 @TestPropertySource 显式提供配置。
在 spring boot 的 mockito 单元测试中，`@value` 注入的配置属性（如 `aws.s3.bucketname`）为 null，根本原因是 spring 容器未启动、配置文件未加载；解决方法是使用 `@springboottest` 启动最小上下文，并配合 `@testconfiguration` 或 `@testpropertysource` 显式提供配置。
当使用纯 @MockitoExtension 进行单元测试时，Spring 的依赖注入容器（IoC Container）完全不参与对象创建——@InjectMocks 仅通过反射和 Mockito 内部机制构造目标类实例，不会解析 @Value、不会加载 application.yml/application.properties，因此所有 @Value 字段均保持默认值（如 String 为 null），导致运行时 NullPointerException 或业务逻辑异常（如您遇到的 S3 上传失败）。
✅ 正确做法：启用轻量级 Spring 上下文
推荐使用 @SpringBootTest（搭配 classes 属性指定最小必要组件），它会启动嵌入式 Spring 应用上下文，自动加载 application.yml 中的配置，并完成 @Value、@Autowired 等注解的解析与注入：
@ExtendWith(MockitoExtension.class)
@SpringBootTest(classes = {
AsyncPublisherServiceImpl.class,
AsyncPublisherDao.class, // 或使用 @MockBean 替代 @Mock
AsyncUtil.class,
ClientListenerService.class
})
@MockitoSettings(strictness = Strictness.LENIENT)
class AsyncPublisherServiceImplTest {
@Autowired
private AsyncPublisherServiceImpl asyncPublisherServiceImpl;
@MockBean
private AsyncPublisherDao dao;
@MockBean
private AsyncUtil asyncUtil;
@MockBean
private ClientListenerService techpulseservice;
@Test
void publish() {
// 提前配置 mock 行为
when(dao.isValidCount(ConstantsTest.UUID)).thenReturn(true);
when(asyncUtil.generateZip(anyString(), anyList())).thenReturn(new byte[0]);
File file = new File(AsyncUtil.sanitizePathandfilename(ConstantsTest.UUID + ".zip"));
try {
FileUtils.writeByteArrayToFile(file, new byte[0]);
} catch (IOException e) {
throw new RuntimeException(e);
}
// 执行被测方法（此时 bucketName 已由 Spring 注入）
boolean result = asyncPublisherServiceImpl.publish(ConstantsTest.UUID, ConstantsTest.UnitOfWorkId);
assertThat(result).isTrue();
verify(dao).updateLink(eq(ConstantsTest.UUID), anyString());
}
}
⚠️ 关键注意事项：
- 避免混用 @Mock 和 @SpringBootTest：@Mock（来自 Mockito）与 Spring 上下文不兼容；应改用 @MockBean —— 它由 Spring Test 管理，可精准替换 Bean 并支持 @SpyBean、重置等高级能力；
-
配置文件必须可达：确保 src/test/resources/application.yml 存在且包含有效配置，例如：
aws: s3: bucketName: "test-bucket" region: "us-west-2"若需覆盖生产配置，可添加 @TestPropertySource(properties = {"aws.s3.bucketName=test-bucket"})；
-
性能权衡：@SpringBootTest 启动上下文比纯 Mockito 测试慢。若仅需验证逻辑（不依赖真实配置），更优方案是手动设置字段值（适用于简单场景）：
@BeforeEach void setUp() { ReflectionTestUtils.setField(asyncPublisherServiceImpl, "bucketName", "test-bucket"); }但此方式绕过 Spring 生命周期，不推荐用于含复杂初始化逻辑的 Service。
? 总结：@Value 是 Spring 框架级功能，脱离 Spring 容器即失效。单元测试中需明确选择测试范式——纯 Mockito（快，无 IoC） or Spring Integration Test（准，有 IoC）。对于涉及配置注入、事务、AOP 的 Service 层测试，@SpringBootTest + @MockBean 是标准且可靠的实践。
