Spring Boot異常處理問題小結(jié)

更新時(shí)間：2024年05月15日 12:04:35 作者：啊Q老師

在 Spring Boot 中,異常處理是一個(gè)重要的部分,可以允許開發(fā)者優(yōu)雅地處理應(yīng)用程序中可能發(fā)生的錯(cuò)誤和異常,這篇文章主要介紹了Spring Boot異常處理問題小結(jié),需要的朋友可以參考下

Spring Boot

前言

在 Spring Boot 中，異常處理是一個(gè)重要的部分，可以允許開發(fā)者優(yōu)雅地處理應(yīng)用程序中可能發(fā)生的錯(cuò)誤和異常。Spring Boot 提供了一套完整的機(jī)制來處理異常，包括全局異常處理、特定異常處理以及自定義錯(cuò)誤頁面等。而當(dāng) Spring Boot 應(yīng)用程序中發(fā)生異常時(shí)，Spring Boot 默認(rèn)會(huì)提供一個(gè)錯(cuò)誤頁面來顯示錯(cuò)誤信息。這個(gè)默認(rèn)的錯(cuò)誤頁面通常包括一個(gè)錯(cuò)誤狀態(tài)碼（如 404 或 500 ），一個(gè)簡(jiǎn)短的錯(cuò)誤描述，以及一個(gè)可選的堆棧跟蹤（這取決于應(yīng)用程序的配置）。通常情況下，開發(fā)者往往傾向于自定義錯(cuò)誤頁面。下面簡(jiǎn)單介紹 Spring Boot 異常處理的方式。

使用自定義錯(cuò)誤頁面處理異常

在 Spring Boot 中，自定義錯(cuò)誤頁面是一種常用來處理異常的方式，并提供用戶友好的反饋。開發(fā)者可以為特定的 HTTP 狀態(tài)碼（如404、 500等）創(chuàng)建自定義的錯(cuò)誤頁面，也可以創(chuàng)建一個(gè)通用的錯(cuò)誤頁面來處理所有未捕獲的異常。

簡(jiǎn)單示例：
首先，在 src/main/resources/templates 目錄下創(chuàng)建一個(gè)錯(cuò)誤頁面，名為 Error.html 的 Thymeleaf 視圖模板

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>ErrorDemo</title>
</head>
    <body>
        <h1 th:text="${status}">異常狀態(tài)碼</h1>
        <p th:text="${error}">錯(cuò)誤提示信息</p>
        <p th:if="${message}">異常消息<span th:text="${message}"></span></p>
        <p th:text="exception">錯(cuò)誤對(duì)象</p>
        <p th:text="errors">JSR303數(shù)據(jù)校驗(yàn)的異常信息</p>
        <p>Return to <a th:href="@{/}" rel="external nofollow" >Home</a>.</p>
    </body>
</html>

然后，創(chuàng)建 Controller 包再創(chuàng)建一個(gè) TestController 類，并創(chuàng)建一個(gè) Test.html

package cn.edu.SpringBootExceptionHandlingDemo.Controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class TestController {
    @GetMapping("/Test.html")
    public String index(){
        return "Test";
    }
}

最后，啟動(dòng) Spring Boot ，故意觸發(fā)異常（如訪問一個(gè)不存在的 URL ），以查看自定義錯(cuò)誤頁面
結(jié)果如圖：

使用 @ExceptionHandler 注解處理異常

在 Spring 中，@ExceptionHandler 注解允許指定一個(gè)方法來處理特定類型的異常。當(dāng)你在控制器（ Controller ）或全局異常處理類（使用@ControllerAdvice 注解）中使用 @ExceptionHandler 注解時(shí)，Spring 會(huì)自動(dòng)將匹配的異常傳遞給相應(yīng)的方法進(jìn)行處理。

簡(jiǎn)單示例：
首先，在 TestController 類上添加一個(gè)數(shù)學(xué)運(yùn)算的實(shí)現(xiàn)，再使用 @ExceptionHandler 注解指定數(shù)字運(yùn)算類型的異常使用 testError() 方法進(jìn)行異常處理

package cn.edu.SpringBootExceptionHandlingDemo.Controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class TestController {
    @GetMapping("/Test.html")
    public String index(){
        double math = 20240329/0;
        return "Test";
    }
    // 指定數(shù)字運(yùn)算異常后，使用該方法進(jìn)行異常處理
    @ExceptionHandler(value = {java.lang.ArithmeticException.class})
    public ModelAndView testError(Exception exception){
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("err",exception);
        // 指定錯(cuò)誤視圖模板
        modelAndView.setViewName("ErrorExceptionHandler");
        return modelAndView;
    }
}

然后，在 Test.html 上添加運(yùn)算結(jié)果，并創(chuàng)建錯(cuò)誤視圖模板 ErrorExceptionHandler.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Test</title>
</head>
<body>
    運(yùn)算結(jié)果為：<p th:text="${math}" />
    Hello World!!!
</body>
</html>

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>ErrorExceptionHandlerDemo</title>
</head>
<body>
    異常信息：[[${err}]]
</body>
</html>

最后，啟動(dòng) Spring Boot ，打開瀏覽器輸入 http://localhost:8080/Test.html 并按下回車鍵
結(jié)果如圖：

使用 @ControllerAdvice 注解處理異常

使用 @ExceptionHandler 注解雖然比自定義錯(cuò)誤頁面更加靈活處理異常，但是只局限于使用該注解的 Controller 類內(nèi)部上。而使用@ControllerAdvice 注解可以定義一個(gè)類來包含多個(gè) @ExceptionHandler 方法，每個(gè)方法處理特定類型的異常。這樣，便不需要在每個(gè)控制器中重復(fù)編寫異常處理邏輯了。

簡(jiǎn)單示例：
在 Contoller 包內(nèi)創(chuàng)建一個(gè) AdviceController 類，將上述 @ExceptionHandler 方法剪切到該位置

package cn.edu.SpringBootExceptionHandlingDemo.Controller;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.servlet.ModelAndView;
@ControllerAdvice
public class AdviceController {
    // 指定數(shù)字運(yùn)算異常后，使用該方法進(jìn)行異常處理
    @ExceptionHandler(value = {java.lang.ArithmeticException.class})
    public ModelAndView testError(Exception exception){
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("err",exception);
        // 指定錯(cuò)誤視圖模板
        modelAndView.setViewName("ErrorExceptionHandler");
        return modelAndView;
    }
}

最后，啟動(dòng) Spring Boot ，打開瀏覽器輸入 http://localhost:8080/Test.html 并按下回車鍵
結(jié)果一樣，但使用 @ControllerAdvice 注解無需重復(fù)編寫異常處理邏輯：

使用配置類處理異常

在 Spring 中，SimpleMappingExceptionResolver 是一個(gè)方便的異常解析器，可以將特定類型的異常映射到特定的視圖名稱，使得異常處理更加簡(jiǎn)單和統(tǒng)一；也可以通過配置類來配置 SimpleMappingExceptionResolver ，以便在應(yīng)用程序中全局處理異常。

簡(jiǎn)單示例：
創(chuàng)建 Configuration 包并在包內(nèi)創(chuàng)建一個(gè) ErrorConfiguration 配置類，將 AdviceController 類移除或注釋以免影響測(cè)試結(jié)果

package cn.edu.SpringBootExceptionHandlingDemo.Configuration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.handler.SimpleMappingExceptionResolver;
import java.util.Properties;
@Configuration
public class ErrorConfiguration {
    @Bean
    public SimpleMappingExceptionResolver simpleMappingExceptionResolver(){
        SimpleMappingExceptionResolver simpleMappingExceptionResolver = new SimpleMappingExceptionResolver();
        Properties properties = new Properties();
        // 異常處理類型、顯示錯(cuò)誤視圖名稱
        properties.put("java.lang.ArithmeticException","ErrorExceptionHandler.html");
        simpleMappingExceptionResolver.setExceptionMappings(properties);
        // 指定異常信息變量名稱為 err ，默認(rèn)為 exception
        simpleMappingExceptionResolver.setExceptionAttribute("err");
        return simpleMappingExceptionResolver;
    }
}

最后，啟動(dòng) Spring Boot ，打開瀏覽器輸入 http://localhost:8080/Test.html 并按下回車鍵
結(jié)果一樣：

使用自定義類處理異常

在 Spring Boot 中，也可以創(chuàng)建一個(gè)自定義的異常處理器，通常通過實(shí)現(xiàn) HandlerExceptionResolver 接口或繼承 SimpleMappingExceptionResolver 類，并在其中添加自定義邏輯，便可以處理異常。

簡(jiǎn)單示例：
接著，在 Configuration 內(nèi)創(chuàng)建一個(gè) CustomErrorConfiguration 自定義類并實(shí)現(xiàn) HandlerExceptionResolver 接口，將 ErrorConfiguration 配置類和 AdviceController 類移除或注釋以免影響測(cè)試結(jié)果

package cn.edu.SpringBootExceptionHandlingDemo.Configuration;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
@Configuration
public class CustomErrorConfiguration implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        ModelAndView modelAndView = new ModelAndView();
        // 數(shù)字運(yùn)算類型異常
        if(ex instanceof ArithmeticException){
            modelAndView.setViewName("ErrorExceptionHandler");
        }
        // 異常信息對(duì)象
        modelAndView.addObject("err",ex);
        return modelAndView;
    }
}

最后，啟動(dòng) Spring Boot ，打開瀏覽器輸入 http://localhost:8080/Test.html 并按下回車鍵
結(jié)果一樣：