应通过@ControllerAdvice+@ExceptionHandler统一捕获HttpRequestMethodNotSupported异常，返回含code=405、message及allowedMethods字段的JSON响应，并记录日志告警；同时检查接口注解与调用方法是否一致以规避误配。
在 Spring MVC 中，HttpRequestMethodNotSupported 异常（HTTP 405 Method Not Allowed）通常表示客户端用不支持的 HTTP 方法（比如用 POST 访问只标注了 @GetMapping 的接口）请求了某个端点。优雅处理它，核心是：**不让用户看到白页或默认错误页，而是返回结构清晰、语义明确的响应，并可选记录日志或做监控。**
统一异常处理器拦截
最推荐的方式是通过 @ControllerAdvice + @ExceptionHandler 全局捕获：
- 创建一个全局异常处理器类，添加
@ControllerAdvice注解 - 在其中定义方法，参数为
HttpRequestMethodNotSupported，加上@ExceptionHandler - 方法内构造标准响应体（如封装
code=405、message="Method not allowed"、supportedMethods=["GET","HEAD"]等信息） - 返回
ResponseEntity<Result>并设置状态码为HttpStatus.METHOD_NOT_ALLOWED
补充：在响应中明确返回允许的方法
Spring 默认会在响应头中设置 Allow: GET, HEAD，但前端可能不读头。建议在 JSON 响应体中也显式带上 allowedMethods 字段：
{ "code": 405, "message": "Request method 'POST' is not supported", "allowedMethods": ["GET", "HEAD"] }
立即学习“Java免费学习笔记（深入）”；
避免误配：检查 Controller 方法签名
很多 405 实际源于配置疏忽，提前规避比事后处理更重要：
- 确认
@RequestMapping的method属性或派生注解（@GetMapping等）与前端调用一致 - 注意 RESTful 接口路径是否重复（如
/users同时存在@PostMapping和@GetMapping，但少写了一个），导致某个方法被覆盖 - 检查是否有
@RequestBody参数却用了 GET —— 这不会直接报 405，但可能因参数绑定失败转为其他异常，需一并排查
可选：记录日志并告警（生产环境）
高频出现的 405 往往意味着前端调用错误或爬虫乱扫，值得追踪：
- 在异常处理器中记录 WARN 或 ERROR 日志，包含请求路径、不支持的方法、客户端 IP、User-Agent
- 对特定路径（如管理后台接口）或高频率（如 1 分钟超 10 次）的 405 做轻量级埋点或推送告警
- 避免记录敏感参数（如 query 中的 token），必要时脱敏
