Java後端開發你應該知道的全局異常處理

在開發Web應用程式時，異常處理是一項非常重要的任務。異常處理可以提高程式的健壯性和穩定性。Java後端開發人員可以設計一個統一的全局異常處理方案來解決異常處理的問題，避免代碼備援，提高開發效率。在本文中，我們将介紹如何設計Java後端的全局異常處理方案。

什麼是全局異常處理？

全局異常處理是一種将異常處理代碼從業務邏輯中分離出來的技術。在Java中，全局異常處理使用@ControllerAdvice注解定義一個全局的異常處理類。在該類中，使用@ExceptionHandler注解捕獲異常并進行處理。使用全局異常處理技術，可以統一處理異常，提高代碼的複用性，降低代碼的備援度。

如何設計Java後端的全局異常處理方案？

設計Java後端的全局異常處理方案包括以下幾個步驟：

1. 定義自定義異常類

定義自定義異常類可以使異常資訊更加明确，友善後續的處理。自定義異常類需要繼承Exception類或其子類。在自定義異常類中，可以定義異常編碼和異常消息。

public class MyException extends Exception {
     private String code;
     private String message;
 
     public MyException(String code, String message) {
         this.code = code;
         this.message = message;
     }
 ​
     public String getCode() {
         return code;
     }
 ​
     public String getMessage() {
         return message;
     }
 }
複制代碼           

2. 定義全局異常處理類

定義全局異常處理類需要使用@ControllerAdvice注解。在該類中，使用@ExceptionHandler注解捕獲異常并進行處理。

@ControllerAdvice
 public class GlobalExceptionHandler {
     @ExceptionHandler(MyException.class)
     @ResponseBody
     public ResponseEntity<ErrorResponse> handleMyException(MyException e) {
         ErrorResponse errorResponse = new ErrorResponse(e.getCode(), e.getMessage());
         return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
     }
 ​
     @ExceptionHandler(Exception.class)
     @ResponseBody
     public ResponseEntity<ErrorResponse> handleException(Exception e) {
         ErrorResponse errorResponse = new ErrorResponse("500", e.getMessage());
         return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
     }
 }
複制代碼           

@ControllerAdvice注解可以讓我們定義一個全局的異常處理類。@ExceptionHandler注解用于捕獲異常，并将異常資訊封裝到ErrorResponse類中。@ResponseBody注解用于傳回自定義的異常資訊，HttpStatus.INTERNAL_SERVER_ERROR表示傳回500錯誤。

3. 定義異常編碼和異常消息

在自定義異常類中，我們需要定義異常編碼和異常消息。

public class ErrorResponse {
     private String code;
     private String message;
 ​
     public ErrorResponse(String code, String message) {
         this.code = code;
         this.message = message;
     }
 ​
     public String getCode() {
         return code;
     }
 ​
     public String getMessage() {
         return message;
     }
 }
複制代碼           

4. 前端處理異常資訊

前端可以根據傳回的異常編碼和異常消息，對異常進行相應的處理。在使用Axios進行資料請求時，可以通過攔截器攔截傳回的異常資訊。

import axios from 'axios'
 ​
 axios.interceptors.response.use(
     response => response,
     error => {
         const response = error.response;
         if (response.status === 500) {
             console.log(response.data.code, response.data.message);
         }
         return Promise.reject(error);
     }
 );
複制代碼           

在攔截器中，使用if語句判斷是否傳回500錯誤。如果是，就将異常編碼和異常消息輸出到控制台上。這樣，在前端出現異常時，我們可以通過控制台輸出的資訊快速定位異常，進行相應的處理。

利用面向切面AOP對全局異常進行處理

利用面向切面程式設計（AOP）可以更友善地實作Java後端的全局統一異常處理。我們可以通過AOP将異常處理代碼從業務邏輯代碼中分離出來，降低代碼耦合度，提高代碼的可維護性和可擴充性。

下面是利用AOP實作Java後端全局統一異常處理的步驟：

1. 定義一個異常處理類，用于處理全局異常。

@ControllerAdvice
 public class GlobalExceptionHandler {
 ​
     /**
      * 處理全局異常
      */
     @ExceptionHandler(Exception.class)
     public ResponseEntity<ErrorResponse> handleException(Exception e) {
         log.error("全局異常資訊：{}", e.getMessage());
         ErrorResponse errorResponse = new ErrorResponse();
         errorResponse.setCode(500);
         errorResponse.setMessage("伺服器出錯啦！");
         return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(errorResponse);
     }
 }
複制代碼           

在上面的代碼中，我們使用@ControllerAdvice注解定義了一個全局異常處理類，用于處理所有的異常。在該類中，我們定義了一個handleException方法，該方法用于處理所有的異常，将異常資訊封裝到一個ErrorResponse對象中，并将該對象傳回給前端。

1. 定義一個切面類，用于捕獲所有的異常。

@Aspect
 @Component
 public class ExceptionAspect {
 ​
     @Around("execution(* com.example.demo.controller.*.*(..))")
     public Object handleException(ProceedingJoinPoint pjp) throws Throwable {
         Object result;
         try {
             result = pjp.proceed();
         } catch (Exception e) {
             log.error("異常資訊：{}", e.getMessage());
             ErrorResponse errorResponse = new ErrorResponse();
             errorResponse.setCode(500);
             errorResponse.setMessage("伺服器出錯啦！");
             return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(errorResponse);
         }
         return result;
     }
 }
複制代碼           

在上面的代碼中，我們使用@Aspect注解定義了一個切面類，用于捕獲所有的異常。在該類中，我們定義了一個handleException方法，該方法用于處理所有的異常。如果有異常發生，該方法會将異常資訊封裝到一個ErrorResponse對象中，并将該對象傳回給前端。

1. 配置AOP。

在Spring Boot中，我們可以通過@Configuration注解定義一個配置類，并使用@EnableAspectJAutoProxy注解開啟AOP功能。

javaCopy code@Configuration
 @EnableAspectJAutoProxy
 public class AopConfig {
 ​
 }
複制代碼           

在上面的代碼中，我們定義了一個AopConfig類，并使用@EnableAspectJAutoProxy注解開啟AOP功能。

1. 測試。

現在，我們已經完成了全局統一異常處理的配置，可以進行測試了。在測試過程中，如果出現異常，會自動被切面類捕獲并處理，傳回給前端一個ErrorResponse對象。

javaCopy code@RestController
 public class TestController {
 ​
     @GetMapping("/test")
     public String test() {
         int i = 1 / 0;
         return "test";
     }
 }
複制代碼           

在上面的代碼中，我們定義了一個TestController類，并在其中的test方法中故意抛出一個異常。當我們通路該接口時，會自動被切面類捕獲并進行統一異常處理。

在這個例子中，我們使用了切面技術實作了全局統一異常處理，這種方式相比于try-catch代碼塊的方式更加簡潔和優雅，也更易于維護。同時，AOP還可以用于處理其他方面的邏輯，比如日志、緩存、權限控制等。

當然，這種方式也存在一些限制和注意事項。比如，如果應用中存在多個切面，可能會出現切面的執行順序問題，需要手動配置切面執行的順序。另外，在使用AOP時，也需要注意對性能的影響，如果切面代碼邏輯過于複雜或者切入的方法過多，可能會對應用的性能産生一定的影響。

全局統一異常處理是Java後端開發中不可或缺的一部分，通過切面技術實作全局異常處理可以有效地提高代碼的可維護性和可讀性，也可以更加友善地對異常資訊進行管理和處理。

總結

在Java後端開發中，異常處理是一項非常重要的任務。通過設計一個統一的全局異常處理方案，我們可以将異常處理代碼從業務邏輯中分離出來，避免代碼備援，提高開發效率。在本文中，我們介紹了Java後端的全局異常處理方案，包括定義自定義異常類、定義全局異常處理類、定義異常編碼和異常消息以及前端處理異常資訊。希望本文能夠對Java後端開發人員設計統一全局異常處理方案有所幫助。定性。

原文連結：https://juejin.cn/post/7226177081197019194