Spring Boot集成Spring Security实现Basic+JWT认证测试失败求解

1. 确认测试上下文加载了自定义Security配置 #

@WebMvcTest注解默认仅扫描Controller层Bean，不会自动加载你自定义的WebSecurityConfigurerAdapter、SecurityContextRepository、AuthenticationManager等安全相关组件，测试环境实际走的是Spring Security默认配置，自然会返回401。
解决方案：

• 若使用MockMvc做接口测试，在测试类上加@Import(你的自定义WebSecurity配置类.class)手动导入安全配置
• 或直接使用@SpringBootTest + @AutoConfigureMockMvc组合注解，自动加载全量应用配置包括自定义安全规则

2. 检查MockMvc是否启用了Security过滤器 #

如果是手动构建MockMvc实例，必须显式引入Spring Security过滤器链，否则请求不会经过你的认证逻辑：

@Autowired
private WebApplicationContext context;
private MockMvc mockMvc;

@BeforeEach
void initMockMvc() {
    mockMvc = MockMvcBuilders.webAppContextSetup(context)
        // 必须加该行，才会加载Spring Security过滤器链
        .apply(springSecurity())
        .build();
}

3. 验证SecurityContextRepository注入状态 #

你自定义的SecurityContextRepository如果未被测试上下文加载，默认会使用HttpSessionSecurityContextRepository，而Mock请求默认无会话上下文，即使认证通过也无法将认证信息存入上下文，后续鉴权阶段仍会判定为未登录。
你可以直接在测试类中通过@Autowired注入SecurityContextRepository，如果注入失败则说明安全配置未正确加载。

4. 校验认证逻辑的测试环境适配 #

在AuthenticationManager认证逻辑结束位置打断点，确认两个信息：

• 返回的Authentication对象的isAuthenticated()属性是否为true：如果为false，大概率是测试环境缺少必要配置，比如JWT签名密钥、Basic认证的账号密码仅在生产配置文件加载，测试配置未同步
• 认证完成后的Authentication对象是否被正确存入SecurityContext：如果已生成合法认证对象但仍返回401，检查你自定义的SecurityContextRepository的存储逻辑是否适配测试环境，比如存储介质是Redis但测试环境未启动Redis实例

5. 区分401的实际触发原因 #

Spring Security返回的401可能对应两种场景：未认证、权限不足。你可以在ExceptionTranslationFilter的异常捕获逻辑处打断点，确认捕获的是AuthenticationException还是AccessDeniedException：如果是后者，说明你的测试请求路径对应的权限规则在测试环境配置有误，比如生产配置是/api/**需普通用户权限，测试配置不小心写为需ADMIN权限。

6. 依赖版本一致性校验 #

确认spring-security-test依赖的版本和项目主版本的Spring Security版本完全一致，版本不匹配会导致过滤器链加载异常，认证逻辑无法正常触发。

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