Java中处理405异常的核心是捕获HttpRequestMethodNotSupportedException，在@ControllerAdvice全局处理器中用@ExceptionHandler拦截并返回标准JSON响应，同时确保控制器方法注解（如@GetMapping）与前端请求方法严格匹配。
Java 中处理 405（Method Not Allowed）异常，核心是捕获 HttpRequestMethodNotSupportedException，并在全局异常处理器中统一响应。它不是业务异常，而是 Spring MVC 在请求方法（如 POST）与控制器方法标注的 @GetMapping 不匹配时自动抛出的运行时异常。
定义全局异常处理器捕获 HttpMethod 不匹配
使用 @ControllerAdvice + @ExceptionHandler 拦截该异常：
// 示例：全局异常处理器
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
@ResponseStatus(HttpStatus.METHOD_NOT_ALLOWED)
@ResponseBody
public Map<String, Object> handleMethodNotSupported(
HttpRequestMethodNotSupportedException ex) {
Map<String, Object> result = new HashMap<>();
result.put("code", 405);
result.put("message", "请求方法不支持：" + ex.getMethod());
result.put("supportedMethods", Arrays.asList(ex.getSupportedMethods()));
return result;
}
}
确保控制器方法签名与请求一致
405 多数源于开发阶段配置疏漏，需检查：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
- 前端发的是 POST，但后端用
@GetMapping接收 - 接口路径正确，但
@PostMapping("/api/user")和实际调用的/api/user/（带斜杠）因路径匹配策略不同被识别为不同端点 - Spring Boot 2.6+ 默认关闭了
useTrailingSlashMatch，建议显式配置以避免歧义：spring.mvc.pathmatch.matching-strategy=ant_path_matcher（仅旧版兼容）或改用PathPatternParser并规范路径写法
补充：自定义 405 响应格式（如返回 JSON + 状态码）
若项目统一用 ResponseEntity，可改写为：
@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
public ResponseEntity<Map<String, Object>> handleMethodNotSupported(
HttpRequestMethodNotSupportedException ex) {
Map<String, Object> body = Map.of(
"code", 405,
"message", "不支持的请求方法",
"method", ex.getMethod(),
"allowed", String.join(",", ex.getSupportedMethods())
);
return ResponseEntity.status(HttpStatus.METHOD_NOT_ALLOWED).body(body);
}
这样能确保 HTTP 状态码真实返回 405，前端可通过 response.status === 405 可靠判断。
