Spring Security集成测试：如何避免逐类注入安全相关Mock Bean

• @WebMvcTest作为MVC层切片测试注解，默认仅扫描Web层相关组件，不会加载项目中标记为@Service、@Component、数据层数据源类的Bean；同时其内置的自动配置机制会主动加载项目中所有继承WebSecurityConfigurerAdapter的安全配置类。
• 遇到的依赖注入报错触发链路为：Spring自动加载生产环境的SecurityConfiguration类时，需要注入其构造方法依赖的UserDetailsServiceImpl、JwtAuthenticationProvider、DataSource三类非Web层Bean，而切片测试场景下容器中不存在这些Bean定义，因此启动失败。
• 此前两种优化方案失效的本质：直接@Import导入生产SecurityConfiguration、通过@ContextConfiguration指定该类为配置来源时，都会触发完整的安全配置初始化流程，依然会因为缺失对应依赖链，无法完成Bean创建。
• 逐类添加@MockBean的临时方案冗余，核心原因是没有将公共的安全测试依赖抽离为可复用的配置单元。

1. 抽离测试侧公共安全配置 #

在测试源码目录（src/test/java）下创建专门的测试配置类，统一管理安全相关的Mock Bean定义，无需依赖生产代码的组件扫描逻辑：

@TestConfiguration
public class CommonTestSecurityConfig {
    // 直接复用生产环境的SecurityConfiguration实现，注入Mock依赖完成Bean实例化
    @Bean
    public SecurityConfiguration securityConfiguration(
        UserDetailsServiceImpl mockUserDetailsService,
        JwtAuthenticationProvider mockJwtAuthProvider,
        DataSource mockDataSource
    ) {
        // 直接传入Mock依赖实例化生产配置类，无需重复编写安全规则逻辑
        return new SecurityConfiguration(mockUserDetailsService, mockJwtAuthProvider, mockDataSource);
    }

    // 统一注册安全配置依赖的Mock Bean
    @Bean
    public UserDetailsServiceImpl userDetailsServiceImpl() {
        return Mockito.mock(UserDetailsServiceImpl.class);
    }

    @Bean
    public JwtAuthenticationProvider jwtAuthenticationProvider() {
        return Mockito.mock(JwtAuthenticationProvider.class);
    }

    @Bean
    public DataSource dataSource() {
        return Mockito.mock(DataSource.class);
    }
}

该配置类仅服务于测试场景，不会影响生产代码的Bean加载逻辑。

2. 封装通用测试组合注解 #

将所有测试类需要统一引入的配置（业务侧的ErrorHandlerConfiguration、上述安全测试配置）封装为可复用的元注解，消除重复的@Import导入逻辑：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@WebMvcTest
@Import({ErrorHandlerConfiguration.class, CommonTestSecurityConfig.class})
public @interface CommonWebMvcSliceTest {
    // 保留原@WebMvcTest指定测试Controller的能力
    @AliasFor(annotation = WebMvcTest.class, attribute = "value")
    Class<?>[] controllers() default {};
}

3. 简化测试类编写 #

后续所有Web层集成测试可直接使用自定义组合注解，无需重复声明任何安全相关的Mock导入：

// 原冗余写法
// @WebMvcTest(SomeController.class)
// @Import(ErrorHandlerConfiguration.class)
// @MockBean UserDetailsServiceImpl userDetailsService;
// @MockBean JwtAuthenticationProvider jwtAuthenticationProvider;
// @MockBean DataSource dataSource;

// 简化后的测试类声明
@CommonWebMvcSliceTest(controllers = SomeController.class)
class SomeControllerTest {
    // 测试逻辑正常编写即可，所有安全相关依赖已由公共配置自动注入Mock实现
}

• 所有安全测试相关的Bean配置仅需维护一份，后续新增任何Web层测试类时，不需要重复编写@MockBean、@Import等重复逻辑；如果SecurityConfiguration后续新增构造依赖，仅需在公共测试配置中补充对应Mock Bean定义，所有关联测试类无需改动。
• 直接复用生产环境的SecurityConfiguration实现，不需要在测试侧重复编写一遍Web安全规则，避免测试配置和生产配置出现逻辑偏差。
• 组合注解的写法符合Spring Boot测试切片的设计规范，不会引入额外的容器加载开销。

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