Spring Boot POST请求异常返回405状态码问题排查求助

看起来你遇到的这个405状态码覆盖问题，根源在于Spring Boot默认的/error端点只支持GET和HEAD方法。

当你的POST请求触发错误时（比如访问不存在的端点、抛出内部服务器异常），Spring Boot的错误处理机制会尝试用相同的POST方法转发请求到/error端点，但这个默认端点不支持POST，所以直接返回了405 Method Not Allowed，把原本应该返回的404/500给覆盖了。而GET请求正常的原因也很简单——GET错误请求会用GET方法访问/error，刚好是允许的，所以能返回正确的状态码。

从你提到的405响应Allow头是GET, HEAD也能佐证这一点，这正是默认/error端点支持的方法列表。

下面提供两种可行的解决方法，你可以根据自己的需求选择：

方法一：自定义ErrorController，支持所有HTTP方法 #

创建一个自定义的错误控制器，让它处理所有请求方法，这样不管是POST/PUT/DELETE哪种请求触发的错误，都能正确返回原本的状态码：

@RestController
public class CustomErrorController implements ErrorController {

    private final ErrorAttributes errorAttributes;

    @Autowired
    public CustomErrorController(ErrorAttributes errorAttributes) {
        this.errorAttributes = errorAttributes;
    }

    // 支持所有常用HTTP方法
    @RequestMapping(value = "/error", method = {RequestMethod.GET, RequestMethod.POST, RequestMethod.PUT, RequestMethod.DELETE, RequestMethod.OPTIONS})
    public ResponseEntity<Map<String, Object>> handleError(HttpServletRequest request) {
        // 获取错误详情
        Map<String, Object> errorDetails = errorAttributes.getErrorAttributes(request, ErrorAttributeOptions.defaults());
        // 获取原本的状态码
        HttpStatus status = getStatus(request);
        return new ResponseEntity<>(errorDetails, status);
    }

    private HttpStatus getStatus(HttpServletRequest request) {
        Integer statusCode = (Integer) request.getAttribute("javax.servlet.error.status_code");
        if (statusCode != null) {
            try {
                return HttpStatus.valueOf(statusCode);
            } catch (IllegalArgumentException ignored) {}
        }
        // 默认返回500
        return HttpStatus.INTERNAL_SERVER_ERROR;
    }
}

同时，记得在你的WebSecurityConfig里允许所有人访问/error端点，避免认证拦截：

@Override
protected void configure(HttpSecurity httpSecurity) throws Exception {
    // ... 其他配置保持不变
    httpSecurity
            .cors()
            .and().csrf()
            .disable()
            .authorizeRequests()
            .antMatchers("/error").permitAll() // 新增：允许访问错误端点
            .antMatchers("/api/authenticate").permitAll()
            .antMatchers("/api/**", "/admin/**").authenticated()
            .and()
            .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS);
    // ... 其他配置保持不变
}

方法二：配置Spring MVC抛出未找到处理器异常，用全局异常处理器处理 #

这种方法更直接，让系统在找不到端点时直接抛出异常，然后我们自己捕获处理，绕开默认的/error转发机制：

1. 首先在application.properties中添加配置：

# 找不到处理器时抛出异常
spring.mvc.throw-exception-if-no-handler-found=true
# 禁用静态资源映射的自动处理，避免干扰
spring.web.resources.add-mappings=false

2. 创建全局异常处理器，捕获并处理这些异常：

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理找不到端点的情况
    @ExceptionHandler(NoHandlerFoundException.class)
    public ResponseEntity<String> handleEndpointNotFound(NoHandlerFoundException ex) {
        return new ResponseEntity<>("Requested endpoint does not exist", HttpStatus.NOT_FOUND);
    }

    // 处理其他所有内部异常
    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleInternalError(Exception ex) {
        // 生产环境建议不要返回具体异常信息，这里只是示例
        return new ResponseEntity<>("Internal server error occurred", HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

同样，记得在WebSecurityConfig中允许/error（或者确保异常处理器的响应不会被Security拦截）。

完成配置后，你可以重新测试：

• POST请求到不存在的端点应该返回404 Not Found
• 触发内部服务器错误时，应该返回500 Internal Server Error
• 所有GET请求依然保持正常

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