Spring Boot 中 404 和 500 错误怎么全局捕获-java教程-PHP中文网

Spring Boot中404需配置spring.mvc.throw-exception-if-no-handler-found=true和spring.web.resources.add-mappings=false后，再用@ControllerAdvice捕获NoHandlerFoundException；500可直接通过@ExceptionHandler处理运行时异常。

spring boot 中 404 和 500 错误怎么全局捕获

Spring Boot 中 404 和 500 错误的全局捕获方式不同，核心在于：500 类异常（如 RuntimeException、数据库异常等）可直接用 @ControllerAdvice + @ExceptionHandler 捕获；而 404（即 NoHandlerFoundException）默认不走该机制，需额外配置才能被捕获并统一处理。

下面分两类说明具体做法：

一、500 类异常：用 @ControllerAdvice 自然捕获

这类异常是 Controller 层抛出的未处理运行时异常，Spring MVC 默认会进入全局异常处理器。

只需定义一个带 @ControllerAdvice 的类，并用 @ExceptionHandler 注解方法：

捕获所有异常：@ExceptionHandler(Exception.class)
捕获特定异常：@ExceptionHandler(NullPointerException.class)
方法返回 @ResponseBody 对象（如 Map、自定义 Result），或 ResponseEntity 控制状态码
建议加上 @Order(Ordered.HIGHEST_PRECEDENCE) 确保优先级最高

示例返回 JSON：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    @ResponseBody
    public Map<string object> handle500(Exception e) {
        Map<string object> result = new HashMap();
        result.put("code", 500);
        result.put("msg", "服务器内部错误");
        return result;
    }
}</string></string>

二、404 异常：需开启配置才可捕获

默认情况下，404 不是“抛出的异常”，而是 DispatcherServlet 找不到匹配 Handler 时直接返回的状态码，不会触发 @ExceptionHandler。

要让它也能被全局捕获，必须做两件事：

在 application.properties 或 application.yml 中启用“找不到处理器时抛出异常”：

application.properties：

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

spring.mvc.throw-exception-if-no-handler-found=true
spring.web.resources.add-mappings=false

application.yml：

spring:
  mvc:
    throw-exception-if-no-handler-found: true
  web:
    resources:
      add-mappings: false

然后在 @ControllerAdvice 类中添加专门处理 NoHandlerFoundException 的方法：

@ExceptionHandler(NoHandlerFoundException.class)
@ResponseBody
public Map<string object> handle404(NoHandlerFoundException e) {
    Map<string object> result = new HashMap();
    result.put("code", 404);
    result.put("msg", "请求地址不存在");
    return result;
}</string></string>

⚠️ 注意：spring.web.resources.add-mappings=false 是为了防止静态资源映射干扰 404 判定（尤其在禁用默认静态路径时更稳妥）。