Spring Boot統(tǒng)一異常攔截實(shí)踐指南(最新推薦)
更新時間：2025年02月04日 10:50:50 作者：莫非技術(shù)棧
本文介紹了Spring Boot中統(tǒng)一異常處理的重要性及實(shí)現(xiàn)方案,包括使用`@ControllerAdvice`和`@ExceptionHandler`注解,實(shí)現(xiàn)全局異常處理和統(tǒng)一響應(yīng)格式,本文給大家介紹的非常詳細(xì),感興趣的朋友一起看看吧
Spring Boot統(tǒng)一異常攔截實(shí)踐指南
一、為什么需要統(tǒng)一異常處理
在Web應(yīng)用開發(fā)中，異常處理是保證系統(tǒng)健壯性和用戶體驗(yàn)的重要環(huán)節(jié)。傳統(tǒng)開發(fā)模式中常見的痛點(diǎn)包括：
- 異常處理邏輯分散在各個Controller中
- 錯誤響應(yīng)格式不統(tǒng)一
- 敏感異常信息直接暴露給客戶端
- 重復(fù)編寫相似的異常處理代碼
通過統(tǒng)一異常攔截機(jī)制，我們可以：
- 集中管理異常處理邏輯
- 規(guī)范API錯誤響應(yīng)格式
- 自動轉(zhuǎn)換異常為友好提示
- 減少重復(fù)代碼，提升可維護(hù)性
二、核心實(shí)現(xiàn)方案
1. 基礎(chǔ)組件
Spring Boot提供了兩個關(guān)鍵注解實(shí)現(xiàn)全局異常處理：
@ControllerAdvice：定義全局控制器增強(qiáng)@ExceptionHandler：聲明具體的異常處理方法
2. 實(shí)現(xiàn)步驟
（1）創(chuàng)建自定義異常類
public class BusinessException extends RuntimeException {
private final int code;
public BusinessException(int code, String message) {
super(message);
this.code = code;
}
// getters
}（2）實(shí)現(xiàn)全局異常處理器
@RestControllerAdvice
public class GlobalExceptionHandler {
/**
* 處理業(yè)務(wù)異常
*/
@ExceptionHandler(BusinessException.class)
public ResponseResult<Void> handleBusinessException(BusinessException ex) {
return ResponseResult.fail(ex.getCode(), ex.getMessage());
}
/**
* 處理空指針異常
*/
@ExceptionHandler(NullPointerException.class)
public ResponseResult<Void> handleNullPointerException(NullPointerException ex) {
log.error("空指針異常:", ex);
return ResponseResult.fail(500, "系統(tǒng)內(nèi)部錯誤");
}
/**
* 處理所有未定義異常
*/
@ExceptionHandler(Exception.class)
public ResponseResult<Void> handleGlobalException(Exception ex) {
log.error("系統(tǒng)異常:", ex);
return ResponseResult.fail(500, "系統(tǒng)繁忙，請稍后再試");
}
}（3）統(tǒng)一響應(yīng)格式封裝
@Data
@NoArgsConstructor
@AllArgsConstructor
public class ResponseResult<T> {
private int code;
private String message;
private T data;
public static <T> ResponseResult<T> success(T data) {
return new ResponseResult<>(200, "success", data);
}
public static <T> ResponseResult<T> fail(int code, String message) {
return new ResponseResult<>(code, message, null);
}
}三、高級處理技巧
1. 處理參數(shù)校驗(yàn)異常
配合Validation API自動處理參數(shù)校驗(yàn)錯誤：
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseResult<Void> handleValidException(MethodArgumentNotValidException ex) {
String message = ex.getBindingResult()
.getFieldErrors()
.stream()
.map(FieldError::getDefaultMessage)
.collect(Collectors.joining(", "));
return ResponseResult.fail(400, message);
}2. 處理404錯誤
Spring Boot默認(rèn)的404錯誤需要特殊處理：
@Configuration
public class ErrorConfig implements ErrorController {
@RequestMapping("/error")
public ResponseResult<Void> handleNoHandlerFound() {
return ResponseResult.fail(404, "接口不存在");
}
}3. 區(qū)分生產(chǎn)/開發(fā)環(huán)境
在application.properties中配置：
# 開發(fā)環(huán)境顯示詳細(xì)錯誤 server.error.include-stacktrace=always # 生產(chǎn)環(huán)境隱藏細(xì)節(jié) # server.error.include-stacktrace=never
四、方案優(yōu)勢分析
- 統(tǒng)一響應(yīng)格式：所有異常返回相同結(jié)構(gòu)，方便前端處理
- 異常分類處理：可針對不同異常類型定制處理邏輯
- 敏感信息過濾：避免暴露堆棧信息等敏感內(nèi)容
- 日志集中記錄：統(tǒng)一記錄異常日志，便于問題排查
- 代碼復(fù)用率高：減少Controller層的異常處理代碼
五、最佳實(shí)踐建議
- 定義完善的業(yè)務(wù)異常體系
- 為不同異常類型設(shè)計(jì)合適的HTTP狀態(tài)碼
- 生產(chǎn)環(huán)境關(guān)閉詳細(xì)錯誤信息
- 配合Swagger等工具生成API文檔
- 編寫單元測試驗(yàn)證異常處理邏輯
完整示例代碼結(jié)構(gòu)：
src/main/java
├── exception
│ ├── BusinessException.java
│ └── GlobalExceptionHandler.java
├── config
│ └── ErrorConfig.java
└── model
└── ResponseResult.java通過實(shí)現(xiàn)統(tǒng)一的異常處理機(jī)制，可以顯著提升Spring Boot應(yīng)用的健壯性和可維護(hù)性。開發(fā)者可以專注于業(yè)務(wù)邏輯開發(fā)，同時保證系統(tǒng)的異常處理符合規(guī)范要求。
到此這篇關(guān)于Spring Boot統(tǒng)一異常攔截實(shí)踐指南的文章就介紹到這了,更多相關(guān)Spring Boot異常攔截內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
您可能感興趣的文章:
相關(guān)文章
這篇文章主要介紹了Spring的懶加載機(jī)制原理和配置詳解,Spring提供了懶加載機(jī)制,所謂的懶加載機(jī)制就是可以規(guī)定指定的bean不在啟動時立即創(chuàng)建,而是在后續(xù)第一次用到時才創(chuàng)建,從而減輕在啟動過程中對時間和內(nèi)存的消耗,需要的朋友可以參考下2023-10-10
這篇文章主要介紹了Java面向?qū)ο蟮某橄箢惡徒涌?文中有非常詳細(xì)的代碼示例,對正在學(xué)習(xí)java基礎(chǔ)的小伙伴們有很好的幫助,需要的朋友可以參考下2021-11-11
java的基本數(shù)據(jù)類型及屬性，需要的朋友可以可以參考一下2013-03-03
關(guān)于elcipse 安裝lombok插件解決 @Slf4j 等找不到log變量問題
這篇文章主要介紹了關(guān)于elcipse 安裝lombok插件解決 @Slf4j 等找不到log變量問題,本文給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-01-01
這篇文章主要介紹了Java彈簧布局管理器使用方法詳解,需要的朋友可以參考下2017-09-09
在Spring環(huán)境中正確關(guān)閉線程池的姿勢
這篇文章主要介紹了在Spring環(huán)境中正確關(guān)閉線程池的姿勢，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-04-04
關(guān)于MVC的dao層、service層和controller層詳解
這篇文章主要介紹了關(guān)于MVC的dao層、service層和controller層詳解，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-02-02
這篇文章主要為大家介紹了解決springboot?Long?精度丟失問題的方法詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-07-07
Spring SpringMVC,Spring整合MyBatis 事務(wù)配置的詳細(xì)流程
這篇文章給大家介紹SSM整合詳細(xì)流程步驟 Spring SpringMVC，Spring整合MyBatis 事務(wù)配置，本文通過實(shí)例圖文相結(jié)合給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友參考下吧2020-10-10
Selenium Webdriver實(shí)現(xiàn)截圖功能的示例
今天小編就為大家分享一篇Selenium Webdriver實(shí)現(xiàn)截圖功能的示例，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-05-05