Spring Boot中如何处理METHOD_NOT_ALLOWED 405错误并抛出自定义异常？

首先明确：HttpRequestMethodNotSupportedException不需要你手动抛出，Spring MVC在检测到请求方法与接口支持的方法不匹配时（比如给@GetMapping接口发POST请求），会自动抛出这个异常。你之前在控制器方法里声明throws HttpRequestMethodNotSupportedException完全无效，因为请求根本没进入你的控制器方法就被Spring拦截了。

你的核心问题是异常处理器的作用范围或配置有问题，以下是具体解决步骤：

1. 调整异常处理器为全局生效 #

如果你的异常处理器只是写在单个控制器类中，它只能处理该控制器内的异常。要让它处理所有控制器的方法不匹配异常，需要给异常处理器类添加@RestControllerAdvice注解（替代单个控制器内的局部异常处理）：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
    @ResponseStatus(HttpStatus.METHOD_NOT_ALLOWED)
    public ErrorResponse handleRequestMethodNotSupported(HttpRequestMethodNotSupportedException ex) {
        // 可以优化返回信息，告知用户当前接口支持的请求方法
        String supportedMethods = ex.getSupportedHttpMethods() != null 
            ? String.join(", ", ex.getSupportedHttpMethods()) 
            : "无";
        String message = String.format("请求方法不支持，当前接口允许的方法：%s", supportedMethods);
        return new ErrorResponse(HttpStatus.METHOD_NOT_ALLOWED.value(), message);
    }
}

2. 清理控制器方法的无效声明 #

删掉控制器方法中多余的throws HttpRequestMethodNotSupportedException，因为这个异常根本不会在你的方法执行过程中抛出：

@GetMapping
public ResponseEntity<List<SupplierOutputDTO>> getAllSuppliers() {
    return new ResponseEntity<>(service.getAllSuppliers(), HttpStatus.OK);
}

原理说明 #

当你发送不匹配的请求方法时，Spring的DispatcherServlet会在路由匹配阶段就检测到方法不兼容，直接抛出HttpRequestMethodNotSupportedException，此时请求还没进入你的控制器方法。只有全局的异常处理器（带@RestControllerAdvice/@ControllerAdvice）才能捕获这个阶段的异常，局部控制器内的@ExceptionHandler无法拦截。

完成以上修改后，再用Postman发送POST请求到该接口，就会返回你自定义的ErrorResponse结构，而不是默认的405响应。

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