本文讲解在移除 @Lazy 后，如何避免 Spring 启动时因缺失依赖而失败，同时完成对配置类中带参数 Bean 方法的单元测试——核心方案是区分纯单元测试（无 Spring 上下文）与集成测试（使用 @MockBean + @SpringBootTest）。

本文讲解在移除 `@lazy` 后，如何避免 spring 启动时因缺失依赖而失败，同时完成对配置类中带参数 bean 方法的单元测试——核心方案是区分纯单元测试（无 spring 上下文）与集成测试（使用 `@mockbean` + `@springboottest`）。

在 Spring 应用中，配置类（@Configuration）中的 @Bean 方法若依赖外部参数（如 AwsCredentialsProperties），其测试策略需根据是否启用 Spring 容器而动态调整。当您移除 @Lazy 后，Spring 会在上下文刷新阶段立即尝试创建该 Bean，此时若 AwsCredentialsProperties 尚未注册为 Bean，将抛出 NoSuchBeanDefinitionException ——这正是您遇到的“启动即失败”问题。

✅ 推荐方案一：纯单元测试（推荐用于逻辑验证）

若仅需验证 credentialsProvider() 方法内部逻辑（如空值校验、构造逻辑），无需 Spring 容器参与。此时应彻底移除 @SpringBootTest，改用标准 JUnit + Mockito：

@ExtendWith(MockitoExtension.class)
final class AwsConfigurationTests {

  @Mock
  private AwsCredentialsProperties credentialsProperties;

  private AwsConfiguration awsConfiguration; // 直接 new 实例，非 Spring 管理

  @BeforeEach
  void setUp() {
    awsConfiguration = new AwsConfiguration();
  }

  @Test
  void profilePathIsNull() {
    when(credentialsProperties.getProfilePath()).thenReturn(null);

    IllegalArgumentException exception = assertThrows(
        IllegalArgumentException.class,
        () -> awsConfiguration.credentialsProvider(credentialsProperties)
    );
    assertThat(exception).hasMessage("No profile path specified.");
  }
}

✅ 优势：轻量、快速、隔离性强；完全绕过 Spring 初始化流程。
⚠️ 注意：此方式下 awsConfiguration 是普通 Java 对象，不参与依赖注入或 AOP，仅适用于方法级逻辑测试。

✅ 推荐方案二：Spring 集成测试（需完整上下文）

若需验证 Bean 在 Spring 容器中的实际行为（例如与其他 Bean 协作、@PostConstruct、代理等），则保留 @SpringBootTest，但必须使用 @MockBean 替代 @Mock + @InjectMocks：

@SpringBootTest(
    classes = AwsConfiguration.class,
    webEnvironment = SpringBootTest.WebEnvironment.NONE
)
@Import(TestConfig.class) // 可选：显式导入其他必要配置
final class AwsConfigurationTests {

  @MockBean
  private AwsCredentialsProperties credentialsProperties;

  @Autowired
  private AwsConfiguration awsConfiguration; // 从 Spring 上下文中获取真实 Bean

  @Test
  void profilePathIsNull() {
    when(credentialsProperties.getProfilePath()).thenReturn(null);

    assertThrows(
        IllegalArgumentException.class,
        () -> awsConfiguration.credentialsProvider(credentialsProperties),
        "No profile path specified."
    );
  }
}

✅ 优势：真实反映运行时 Bean 生命周期与依赖关系；@MockBean 会自动注册为容器 Bean 并覆盖同类型定义。
⚠️ 注意：@MockBean 必须配合 @SpringBootTest 或 @ContextConfiguration 使用；不可与 @Mock/@InjectMocks 混用，否则 Spring 无法识别该 Mock 为容器内 Bean。

❌ 常见误区与规避

• 错误组合：@SpringBootTest(classes = {...}) + @Mock + @InjectMocks → Spring 不管理 awsConfiguration 实例，导致 credentialsProperties 参数始终为 null 或未注入。
• 遗漏 @MockBean 注册时机：@MockBean 必须在 Spring 上下文刷新前生效，因此不能放在 @Before 中手动注册。
• 误用 @Primary 冲突：若项目中已有 AwsCredentialsProperties 的真实实现，需确保 @MockBean 正确覆盖（默认优先级最高）。

总结

场景	推荐注解	关键点
验证方法内部逻辑（如校验、条件分支）	@ExtendWith(MockitoExtension.class) + 手动 new AwsConfiguration()	无 Spring 上下文，快且纯粹
验证 Bean 在容器中的协作行为	@SpringBootTest + @MockBean + @Autowired	利用 Spring 真实生命周期，Mock 自动注册为容器 Bean

选择哪种方式，取决于您的测试目标：是测「代码逻辑」，还是测「Spring 集成行为」。两者互补，而非互斥。