在 Spring Security 集成测试中，若使用自定义认证过滤器（如 JWT 前置校验），MockMvc 默认不触发该过滤器或未正确设置 SecurityContext，导致测试返回 401；需通过 @WithMockUser 显式注入认证上下文或配置 MockMvc 安全支持。
在 spring security 集成测试中，若使用自定义认证过滤器（如 jwt 前置校验），mockmvc 默认不触发该过滤器或未正确设置 securitycontext，导致测试返回 401；需通过 `@withmockuser` 显式注入认证上下文或配置 mockmvc 安全支持。
当您在 Spring Boot 应用中引入自定义 OncePerRequestFilter（如 AuthGatewayFilter）来增强 JWT 认证逻辑，并通过 addFilterAt(...) 注册到安全链中时，单元测试中的 MockMvc 默认不会自动执行该过滤器——尤其当它依赖真实请求头（如 Authorization: Bearer ...）且内部逻辑未被模拟时，SecurityContextHolder 将保持空状态，最终触发默认的 401 响应。
最直接、推荐的修复方式是：使用 @WithMockUser 注解为测试方法注入预设的认证主体，从而绕过过滤器的原始校验逻辑，确保 SecurityContext 被正确初始化：
@WithMockUser(username = "test@example.com")
@Test
void securityCheckWithOkta() throws Exception {
mockMvc.perform(get("/security-check")
.header("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...")
.header("companyId", "1438"))
.andExpect(status().isOk());
}✅ 注意事项：
- @WithMockUser 会自动创建 UsernamePasswordAuthenticationToken 并设置到 SecurityContext，与您的过滤器中手动构造的 authentication 对象语义一致；
- 若需真实测试自定义过滤器逻辑（例如验证 JWT 签名、解析 claims 或 companyId 校验），则不应依赖 @WithMockUser，而应：
- 在测试配置中启用完整的安全链（确保 authGatewayFilter 被加载）；
- 使用 @AutoConfigureTestDatabase + @TestConfiguration 模拟 JWT 解析服务；
- 或通过 MockMvcBuilders.webAppContextSetup(...).apply(springSecurity()) 显式启用 Spring Security 测试支持（需添加 spring-security-test 依赖）；
- 确保 AuthGatewayFilter 的 @Component 注解生效，且未被 @Profile 或条件化配置排除；
- 过滤器中 setDetails(...) 调用虽非必需，但建议保留以兼容 WebAuthenticationDetails 相关逻辑（如 IP 地址、session ID 记录）。
总结：@WithMockUser 是解决 401 的快捷方案，适用于验证授权路径是否通畅；若目标是端到端测试自定义过滤器行为，则需构建更贴近生产环境的测试上下文，并对 JWT 解析等外部依赖进行可控模拟。
