测试环境中Spring Security集成测试加载ApplicationContext失败

核心问题定位 #

栈追踪显示找不到com.victorleme.parceiriaapi.user.UserService类型的Bean，本质是测试上下文里Spring没扫描到这个类，或者WebSecurityConfig依赖它但测试环境没加载对应的Bean。

排查步骤 #

• 先查UserService类的注解：确认它标了@Service或@Component，要是用了自定义注解，得保证这个注解能被Spring的组件扫描识别。
• 检查测试的组件扫描范围：自定义@IntegrationTest注解里如果有@ComponentScan，得确认扫描路径包含com.victorleme.parceiriaapi.user包；如果用了@SpringBootTest，要确保启动类的包覆盖了UserService所在的子包（Spring Boot默认扫启动类所在包及子包）。
• 核对WebSecurityConfig的依赖注入：WebSecurityConfig里肯定用到了UserService（比如做用户认证），检查注入方式——是用@Autowired还是构造注入？如果是构造注入，别搞私有构造函数，或者用@RequiredArgsConstructor让Spring能识别。
• 排查测试环境配置：用Test Containers的话，确认@IntegrationTest有没有加载WebSecurityConfig所在的配置类，或者@SpringBootTest有没有指定正确的启动类。
• 排除条件注解影响：如果WebSecurityConfig或UserService加了@Conditional相关注解，得确认测试环境满足这些条件（比如对应的配置属性是否存在）。

优化方案（兼容未升级的WebSecurityConfigurerAdapter） #

1. 统一组件扫描配置
   在自定义@IntegrationTest注解里明确指定扫描路径，别依赖默认规则：

   @Target(ElementType.TYPE)
   @Retention(RetentionPolicy.RUNTIME)
   @SpringBootTest
   @ComponentScan(basePackages = {"com.victorleme.parceiriaapi"})
   @Testcontainers
   public @interface IntegrationTest {
   }
   

   或者直接在测试类的@SpringBootTest里指定启动类：@SpringBootTest(classes = ParceiriaApiApplication.class)

2. 改用构造注入替代字段注入
   WebSecurityConfig里优先用构造注入，避免字段注入可能引发的上下文加载问题：

   public class WebSecurityConfig extends WebSecurityConfigurerAdapter {
       private final UserService userService;
   
       public WebSecurityConfig(UserService userService) {
           this.userService = userService;
       }
   
       // 其他Security配置逻辑...
   }
   

3. 显式引入必要配置类
   如果测试只需要加载Security相关配置，在测试类或@IntegrationTest上加@Import(WebSecurityConfig.class)，确保配置类被上下文加载：

   @IntegrationTest
   @Import(WebSecurityConfig.class)
   public class LoginEndpointTest {
       // 测试代码
   }
   

4. 先验证UserService Bean是否存在
   在测试类里加个简单的测试方法，先确认UserService能被注入，缩小问题范围：

   @Autowired
   private UserService userService;
   
   @Test
   void verifyUserServiceBeanExists() {
       assertNotNull(userService);
   }
   

5. 清理测试上下文缓存
   如果是上下文缓存导致的问题，在测试类上加@DirtiesContext，强制每次测试重新加载上下文：

   @IntegrationTest
   @DirtiesContext
   public class LoginEndpointTest {
       // 测试代码
   }
   

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