Spring Security OAuth2：定制身份验证入口点处理401错误
在使用Spring Security OAuth2时，访问/oauth/token端点若缺少必要参数，会抛出401 Unauthorized异常。默认的DelegatingAuthenticationEntryPoint处理方式可能无法满足个性化需求，例如返回特定格式的错误响应或自定义重定向。本文将指导您如何创建和配置自定义AuthenticationEntryPoint来实现更精细的异常处理。
问题：默认入口点优先级高
即使代码中已指定AuthenticationEntryPoint，也可能无效，这是因为DelegatingAuthenticationEntryPoint优先级更高。需要直接在Spring Security配置中覆盖默认行为。
解决方案：两步走
第一步：创建自定义身份验证入口点类
创建一个实现AuthenticationEntryPoint接口的类，并重写commence方法。在此方法中，您可以自定义身份验证失败后的行为，例如返回自定义错误信息、状态码或重定向到特定页面。
import org.springframework.security.core.AuthenticationException;
import org.springframework.security.web.AuthenticationEntryPoint;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
public class CustomAuthenticationEntryPoint implements AuthenticationEntryPoint {
@Override
public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException {
// 自定义处理逻辑，例如：
response.sendError(HttpServletResponse.SC_UNAUTHORIZED, "Unauthorized Access"); // 返回401错误和自定义消息
// 或者：
// response.sendRedirect("/login"); // 重定向到登录页面
// 或者： 返回JSON格式的错误信息 (需要添加相应的处理程序)
}
}
第二步：在Spring Security配置中使用自定义入口点
在Spring Security配置类中，将自定义的AuthenticationEntryPoint注入到HttpSecurity中，使用exceptionHandling().authenticationEntryPoint()方法：
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http
.authorizeRequests()
.antMatchers("/admin/**").hasRole("ADMIN")
.antMatchers("/user/**").hasRole("USER")
.anyRequest().authenticated()
.and()
.exceptionHandling()
.authenticationEntryPoint(new CustomAuthenticationEntryPoint()) // 注入自定义入口点
.and()
.formLogin()
// ... 登录配置 ...
.and()
.logout()
// ... 注销配置 ...
.and()
.csrf().disable(); // 禁用CSRF (仅供示例，生产环境需谨慎配置)
}
}
通过以上步骤，您已成功自定义Spring Security OAuth2的身份验证入口点，并能根据实际需求灵活处理401错误。 请记住，在生产环境中，应根据安全策略适当地配置CSRF保护。 此外，返回JSON格式的错误信息需要额外的配置，例如添加一个HandlerExceptionResolver来处理异常并返回JSON响应。
