Spring MockMVC单元测试中认证无法传递的原因排查

我之前也碰到过类似的测试场景，OAuth2认证对象明明在测试代码里传了，但控制器就是拿不到，给你几个排查和解决的方向：

1. 先确认getOauthUserAuthentication()的构建逻辑是否完整 #

很多时候问题出在认证对象的构建上，要确保返回的是完整的OAuth2Authentication实例，不能只简单构造用户认证部分。比如正确的构建方式应该包含OAuth2Request上下文：

private OAuth2Authentication getOauthUserAuthentication() {
    // 构建OAuth2请求上下文
    Map<String, String> requestParams = new HashMap<>();
    OAuth2Request oAuth2Request = new OAuth2Request(
        requestParams,
        "test-client-id", // 客户端ID，根据你的配置调整
        Collections.singletonList(new SimpleGrantedAuthority("ROLE_USER")),
        true, // 是否已批准
        Collections.singleton("read"), // 授权范围
        Collections.emptySet(),
        null, null, null
    );

    // 构建用户身份认证
    UsernamePasswordAuthenticationToken userAuth = new UsernamePasswordAuthenticationToken(
        "vince",
        null, // 密码在测试中可以为空
        Collections.singletonList(new SimpleGrantedAuthority("ROLE_USER"))
    );

    // 组合成完整的OAuth2Authentication
    return new OAuth2Authentication(oAuth2Request, userAuth);
}

如果你的认证对象缺少OAuth2Request部分，MockMvc可能无法识别为合法的OAuth2认证，导致控制器接收不到。

2. 改用Spring Security测试专用的请求处理器 #

直接用with(authentication(auth))有时候对OAuth2认证支持不够，建议换成Spring Security提供的oauth2Authentication()处理器：

import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.oauth2Authentication;

// 测试代码中替换成这个
restMockMvc.perform(get("/api/jobs/{id}", newJob.getId())
        .with(oauth2Authentication(auth)))
    .andExpect(status().isOk());

这个处理器是专门为OAuth2场景设计的，能更可靠地把认证对象注入到请求上下文里。

3. 检查控制器获取认证的方式 #

确保你在控制器里是通过正确的方式获取认证信息，比如：

@GetMapping("/api/jobs/{id}")
public ResponseEntity<Job> getJob(
    @PathVariable Long id,
    Authentication authentication // 直接注入认证对象
) {
    String currentUser = authentication.getName();
    // 业务逻辑...
    return ResponseEntity.ok(job);
}

或者通过SecurityContextHolder获取：

Authentication auth = SecurityContextHolder.getContext().getAuthentication();

注意不要在测试前的代码里意外清空了SecurityContext。

4. 确认测试类的配置是否正确 #

你的测试类需要正确加载Spring Security相关配置：

• 如果是切片测试，要加上@WebMvcTest(YourJobController.class)，并且确保OAuth2的配置类被包含到测试上下文（比如用@Import引入）
• 如果是集成测试，用@SpringBootTest+@AutoConfigureMockMvc，确保@EnableWebSecurity或OAuth2相关配置类被正常加载

如果测试上下文缺少Security配置，MockMvc会忽略认证信息的传递。

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