開篇語

哈嘍，各位小伙伴們，你們好呀，我是喵手。運營社區：C站/掘金/騰訊云/阿里云/華為云/51CTO；歡迎大家常來逛逛

??今天我要給大家分享一些自己日常學習到的一些知識點，并以文字的形式跟大家一起交流，互相學習，一個人雖可以走的更快，但一群人可以走的更遠。

??我是一名后端開發愛好者，工作日常接觸到最多的就是Java語言啦，所以我都盡量抽業余時間把自己所學到所會的，通過文章的形式進行輸出，希望以這種方式幫助到更多的初學者或者想入門的小伙伴們，同時也能對自己的技術進行沉淀，加以復盤，查缺補漏。

小伙伴們在批閱的過程中，如果覺得文章不錯，歡迎點贊、收藏、關注哦。三連即是對作者我寫作道路上最好的鼓勵與支持！

前言

??在開發過程中，異常是不可避免的，尤其是當應用規模越來越大時，異常的管理和處理變得尤為重要。在 Spring Boot 應用中，良好的異常處理不僅能幫助開發者快速定位和修復問題，還能有效優化用戶體驗。通過對異常的全局捕獲和處理，能夠使得系統更加健壯，并且為用戶提供清晰的錯誤信息和友好的反饋。

??本文將介紹如何在 Spring Boot 中進行異常處理，涵蓋從全局異常捕獲到優化用戶體驗的常用實踐。

1. Spring Boot 異常處理的基本概念

在 Spring Boot 中，異常處理主要有以下幾種常見方式：

• 局部異常處理：在控制器（Controller）方法內部處理特定的異常。
• 全局異常處理：使用 @ControllerAdvice 或 @RestControllerAdvice 注解進行全局異常捕獲。
• 自定義異常：通過創建自定義異常類和異常處理類來處理特定場景的異常。

2. 使用 @ExceptionHandler 局部處理異常

在 Spring Boot 中，你可以在單個控制器類中使用 @ExceptionHandler 注解來捕獲和處理異常。這種方式適用于只需要在特定控制器中處理的異常。

示例：局部異常處理

@RestController
public class MyController {@GetMapping("/divide")public int divide(@RequestParam int a, @RequestParam int b) {return a / b;}@ExceptionHandler(ArithmeticException.class)public ResponseEntity<String> handleArithmeticException(ArithmeticException ex) {return new ResponseEntity<>("Error: " + ex.getMessage(), HttpStatus.BAD_REQUEST);}
}

在上面的示例中，當 /divide 路由處理過程中發生 ArithmeticException 異常時，handleArithmeticException 方法將會捕獲這個異常并返回一個自定義的錯誤信息。

優化建議：

局部異常處理適用于單個控制器類，但當異常處理邏輯需要應用于多個控制器時，這種方式就顯得不夠靈活。因此，推薦使用全局異常處理來統一處理應用中的異常。

3. 使用 @ControllerAdvice 和 @RestControllerAdvice 進行全局異常處理

為了簡化全局異常處理，Spring 提供了 @ControllerAdvice 和 @RestControllerAdvice 注解，用于定義全局異常處理類。@RestControllerAdvice 是 @ControllerAdvice 和 @ResponseBody 的結合，適用于處理 RESTful 風格的應用。

示例：全局異常處理

首先創建一個全局異常處理類，使用 @ControllerAdvice 注解：

@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(ArithmeticException.class)public ResponseEntity<String> handleArithmeticException(ArithmeticException ex) {return new ResponseEntity<>("Global Error: " + ex.getMessage(), HttpStatus.BAD_REQUEST);}@ExceptionHandler(Exception.class)public ResponseEntity<String> handleGenericException(Exception ex) {return new ResponseEntity<>("Unexpected Error: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);}
}

在這個例子中，GlobalExceptionHandler 捕獲了全局范圍內的 ArithmeticException 和 Exception，并返回自定義的錯誤信息。@ControllerAdvice 可以捕獲所有控制器中的異常，因此異常處理邏輯可以集中管理。

優化建議：

全局異常處理的優勢是可以統一管理和處理應用中的異常，特別是在開發大型應用時，能夠減少代碼重復。你可以在此類中捕獲各種類型的異常，并進行適當的錯誤響應。

4. 自定義異常和異常處理

在一些情況下，你可能需要為應用創建自定義異常類，以便針對特定的業務場景進行處理。自定義異常類通常繼承 RuntimeException 或 Exception。

示例：自定義異常類

public class ResourceNotFoundException extends RuntimeException {public ResourceNotFoundException(String message) {super(message);}
}

然后，在全局異常處理類中捕獲這個自定義異常：

@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(ResourceNotFoundException.class)public ResponseEntity<String> handleResourceNotFoundException(ResourceNotFoundException ex) {return new ResponseEntity<>("Resource Not Found: " + ex.getMessage(), HttpStatus.NOT_FOUND);}
}

優化建議：

使用自定義異常能夠明確區分不同類型的錯誤，并且可以通過返回不同的 HTTP 狀態碼（如 404、500 等）提供給用戶更明確的信息。

5. 優化用戶體驗：自定義錯誤響應

當異常發生時，簡單的錯誤消息往往不能提供足夠的信息。為了改善用戶體驗，可以通過返回詳細的錯誤響應體來幫助前端或用戶更好地理解錯誤情況。

示例：自定義錯誤響應類

public class ErrorResponse {private String message;private int status;private long timestamp;public ErrorResponse(String message, int status) {this.message = message;this.status = status;this.timestamp = System.currentTimeMillis();}// Getters and setters
}

示例：在異常處理中使用自定義錯誤響應

@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(ResourceNotFoundException.class)public ResponseEntity<ErrorResponse> handleResourceNotFoundException(ResourceNotFoundException ex) {ErrorResponse errorResponse = new ErrorResponse(ex.getMessage(), HttpStatus.NOT_FOUND.value());return new ResponseEntity<>(errorResponse, HttpStatus.NOT_FOUND);}
}

優化建議：

通過自定義錯誤響應類，可以將更多信息傳遞給前端。例如，錯誤消息、狀態碼和時間戳等信息，這些都有助于前端開發人員調試和處理異常。確保錯誤信息清晰且易于理解，以改善用戶體驗。

6. 使用 @ResponseStatus 定義 HTTP 狀態碼

@ResponseStatus 注解可以直接在異常類上指定 HTTP 狀態碼。這樣，當該異常被拋出時，Spring 會自動返回指定的狀態碼。

示例：使用 @ResponseStatus 注解

@ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "Resource Not Found")
public class ResourceNotFoundException extends RuntimeException {public ResourceNotFoundException(String message) {super(message);}
}

這樣，當 ResourceNotFoundException 被拋出時，Spring 會自動返回 HTTP 狀態碼 404，并帶有自定義的錯誤信息。

7. 結論

Spring Boot 的異常處理機制非常強大，通過合理使用全局異常處理、局部異常處理、自定義異常類以及自定義錯誤響應，可以大大提升系統的健壯性和用戶體驗。

1. 局部異常處理：適用于只需要在某個控制器內處理的異常，使用 @ExceptionHandler 注解。
2. 全局異常處理：使用 @ControllerAdvice 或 @RestControllerAdvice 進行全局異常捕獲，便于集中管理異常處理。
3. 自定義異常：通過自定義異常類和自定義異常處理邏輯，使得異常處理更加符合業務需求。
4. 優化用戶體驗：通過返回詳細的錯誤響應，幫助用戶理解問題所在，同時提供更好的錯誤信息。

通過這些優化，你的 Spring Boot 應用將能更好地處理異常，并提升用戶體驗。

… …

文末

好啦，以上就是我這期的全部內容，如果有任何疑問，歡迎下方留言哦，咱們下期見。

… …

學習不分先后，知識不分多少；事無巨細，當以虛心求教；三人行，必有我師焉！！！

wished for you successed ！！！

---

??若喜歡我，就請關注我叭。

??若對您有用，就請點贊叭。
??若有疑問，就請評論留言告訴我叭。

---

版權聲明：本文由作者原創，轉載請注明出處，謝謝支持！