Java Springboot全局异常处理

Java Spring Boot 是一个快速开发框架，可以帮助我们快速构建稳定高效的应用程序。在开发应用程序时，往往需要处理一些在运行期间可能发生的异常错误。为了使应用程序更加健壮与可靠，我们需要进行全局异常处理。

一、为什么需要全局异常处理

全局异常处理在应用中非常重要，主要有以下几个原因：

• 增强用户体验：当应用程序出现异常时，我们可以通过全局异常处理机制在应用程序页面上显示错误信息，提示用户出现了错误，从而更好地增强用户体验。
• 方便排查错误：全局异常处理可以方便我们记录应用程序中的错误信息，便于我们排查错误并快速修复。
• 提高应用程序的健壮性：通过对异常进行统一处理，能够解决异常可能带来的各种不确定性。

二、实现全局异常处理的步骤

下面我们就演示如何使用 Java Spring Boot 框架实现全局异常处理。

1、定义一个异常处理类

在 Java Spring Boot 中，我们可以使用注解 @ControllerAdvice 来定义一个全局异常处理类。

@ControllerAdvice
public class GlobalExceptionHandler {

    /**
     * 处理 Exception 类型的异常
     */
    @ExceptionHandler(Exception.class)
    public ModelAndView handleException(Exception e) {
        ModelAndView mv = new ModelAndView();
        mv.setViewName("error");
        mv.addObject("errorMsg", "出现异常了！");
        mv.addObject("stackTrace", ExceptionUtils.getStackTrace(e));
        return mv;
    }
}

在上述代码中，我们定义了一个全局异常处理类 GlobalExceptionHandler，使用 @ControllerAdvice 注解标注该类。

2、处理异常

在 GlobalExceptionHandler 类中，使用 @ExceptionHandler(Exception.class) 注解标注了一个方法 handleException(Exception e)。该方法会捕获所有类型为 Exception 的异常，然后进行处理，并返回一个 ModelAndView 对象。

在该方法中，我们设置了一个视图名称为 error，并将异常信息和堆栈信息作为属性添加到 ModelAndView 对象中。这样，我们就能很方便地在后面的页面中使用这些信息了。

3、在页面上显示错误信息

要在应用程序的页面上显示错误信息，我们需要在 error.html 页面中添加以下代码：

<h1>Error Occurred</h1>
<p th:text="${errorMsg}"></p>

<h2>Stack Trace:</h2>
<pre th:text="${stackTrace}"></pre>

在上述代码中，我们使用 th:text 标签来显示 errorMsg 和 stackTrace 属性中的信息。

这样，当应用程序出现异常时，会自动跳转到 error.html 页面，并显示错误信息和堆栈信息。

三、全局异常处理示例

下面我们演示两个简单的示例来说明如何使用 Java Spring Boot 实现全局异常处理。

1、处理 NullPointerException 异常

@RestController
public class DemoController {

    @GetMapping("/hello")
    public String hello() {
        String str = null;
        return str.toString();
    }
}

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    public ModelAndView handleNullPointerException(Exception e) {
        ModelAndView mv = new ModelAndView();
        mv.setViewName("error");
        mv.addObject("errorMsg", "您访问的页面不存在！");
        mv.addObject("stackTrace", ExceptionUtils.getStackTrace(e));
        return mv;
    }
}

在上述代码中，我们定义了一个 /hello 接口，该接口会出现 NullPointerException 异常，然后在全局异常处理类中进行处理。如果访问该接口，会自动跳转到 error.html 页面，并显示“您访问的页面不存在！”信息。

2、处理 ArithmeticException 异常

@RestController
public class DemoController {

    @GetMapping("/divide")
    public int divide() {
        int a = 1, b = 0;
        return a / b;
    }
}

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    public ModelAndView handleArithmeticException(Exception e) {
        ModelAndView mv = new ModelAndView();
        mv.setViewName("error");
        mv.addObject("errorMsg", "除数不能为零！");
        mv.addObject("stackTrace", ExceptionUtils.getStackTrace(e));
        return mv;
    }
}

在上述代码中，我们定义了一个 /divide 接口，该接口会出现 ArithmeticException 异常，然后在全局异常处理类中进行处理。如果访问该接口，会自动跳转到 error.html 页面，并显示“除数不能为零！”信息。

四、总结

通过使用 Java Spring Boot 框架实现全局异常处理，可以增强应用程序的健壮性和可靠性，提高用户体验和便于排查错误。同时，我们需要根据实际情况定义不同的全局异常处理类来处理不同类型的异常。