Spring Boot UserRedirectRequiredException问题：需重定向获取用户授权

嘿，我来帮你捋捋这个OAuth2的问题——你碰到的org.springframework.security.oauth2.client.resource.UserRedirectRequiredException，本质是客户端需要引导用户跳转到授权服务器去获取授权同意，但当前代码没正确处理这个重定向流程，才抛出了异常。下面是具体的分析和修复方案：

核心原因 #

这个异常触发的逻辑是：当OAuth2客户端尝试获取访问令牌时，发现用户还未对客户端的资源访问请求进行授权，因此需要将用户重定向到授权服务器完成登录和授权操作。但你的代码没有处理这个重定向逻辑，导致直接抛出了异常。

具体修复步骤 #

1. 检查客户端配置的重定向URI与授权服务器匹配 #

先确认你的OauthConfig.java里配置了正确的授权码模式参数，尤其是重定向URI必须和授权服务器上注册的客户端信息完全一致。示例配置如下：

@Configuration
@EnableOAuth2Client
public class OauthConfig {

    @Bean
    public OAuth2RestTemplate oAuth2RestTemplate(OAuth2ClientContext oAuth2ClientContext,
                                                 OAuth2ProtectedResourceDetails details) {
        return new OAuth2RestTemplate(details, oAuth2ClientContext);
    }

    @Bean
    public OAuth2ProtectedResourceDetails oAuth2ProtectedResourceDetails() {
        AuthorizationCodeResourceDetails details = new AuthorizationCodeResourceDetails();
        details.setClientId("your-client-id"); // 和授权服务器注册的一致
        details.setClientSecret("your-client-secret"); // 和授权服务器注册的一致
        details.setAccessTokenUri("http://localhost:8081/auth/oauth/token");
        details.setUserAuthorizationUri("http://localhost:8081/auth/oauth/authorize");
        details.setScope(Arrays.asList("read", "write")); // 权限范围和授权服务器配置匹配
        details.setRedirectUri("http://localhost:8082/ui/login"); // 必须和授权服务器注册的重定向URI完全一致
        return details;
    }
}

2. 用Spring Security过滤器自动处理重定向逻辑 #

推荐用Spring Security的OAuth2ClientAuthenticationProcessingFilter来接管登录请求，它会自动处理重定向到授权服务器的流程，不用手动捕获异常。示例Security配置：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    private OAuth2ClientContext oAuth2ClientContext;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/ui/login").permitAll()
                .antMatchers("/secure/**").authenticated()
                .and()
            .addFilterBefore(oAuth2ClientFilter(), BasicAuthenticationFilter.class)
            .logout()
                .logoutSuccessUrl("/ui")
                .permitAll();
    }

    private Filter oAuth2ClientFilter() {
        OAuth2ClientAuthenticationProcessingFilter filter = new OAuth2ClientAuthenticationProcessingFilter("/ui/login");
        OAuth2RestTemplate restTemplate = new OAuth2RestTemplate(oAuth2ProtectedResourceDetails(), oAuth2ClientContext);
        filter.setRestTemplate(restTemplate);
        UserInfoTokenServices tokenServices = new UserInfoTokenServices(
                "http://localhost:8081/auth/userinfo", "your-client-id");
        tokenServices.setRestTemplate(restTemplate);
        filter.setTokenServices(tokenServices);
        return filter;
    }

    // 复用之前的OAuth2ProtectedResourceDetails Bean
    @Bean
    public OAuth2ProtectedResourceDetails oAuth2ProtectedResourceDetails() {
        // 同上配置内容
    }
}

这个过滤器会自动处理/ui/login请求：如果用户未授权，直接重定向到授权服务器的登录/授权页；授权完成后，会自动获取令牌并跳转到你的安全URI/secure。

3. 授权服务器端的配置校验 #

确保授权服务器（http://localhost:8081/auth）上的客户端配置满足：

• 授权类型设置为authorization_code（授权码模式）
• 注册的重定向URI包含http://localhost:8082/ui/login
• 客户端ID、密钥、权限范围和你的客户端配置完全匹配

4. 手动处理重定向（备选方案） #

如果是手动调用接口的场景，可以捕获异常并手动触发重定向，示例代码：

@RequestMapping("/ui/login")
public String login(OAuth2RestTemplate oAuth2RestTemplate) {
    try {
        oAuth2RestTemplate.getAccessToken();
        return "redirect:/secure";
    } catch (UserRedirectRequiredException e) {
        // 获取授权服务器的重定向URL，引导用户跳转
        String redirectUrl = e.getRedirectUri();
        return "redirect:" + redirectUrl;
    }
}

验证流程 #

修复后，访问http://localhost:8082/ui，若未认证会自动跳转到http://localhost:8081/auth/login；用户登录并授权后，会跳回http://localhost:8082/ui/login完成令牌获取，最终自动跳转到http://localhost:8082/secure。

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