SpringBoot中默認異常處理機制的實現(xiàn)
在 Spring Boot 中，為了簡化 Web 應用的異常處理流程，它提供了一套默認的全局異常處理機制，其中最核心的就是 /error 接口。這個接口是 Spring Boot 提供的一個內(nèi)置錯誤頁面控制器（BasicErrorController），用于統(tǒng)一返回錯誤信息。
?? 一句話總結(jié)：
? Spring Boot 默認使用 BasicErrorController 來處理所有未被捕獲的異常，并通過 /error 接口返回結(jié)構(gòu)化的錯誤響應或跳轉(zhuǎn)到錯誤頁面（如 HTML 頁面）。
?? 一、默認行為概覽
| 請求類型 | 返回內(nèi)容 |
|---|---|
| 瀏覽器請求（HTML） | 跳轉(zhuǎn)到 /error 頁面（如 error.html） |
| API 請求（JSON/REST） | 返回 JSON 格式的錯誤信息 |
例如：
- 訪問一個不存在的路徑：
GET /not-found - 控制器拋出未處理的異常 都會被 Spring Boot 的
/error端點捕獲并處理。
??? 二、核心組件解析
1.BasicErrorController
這是 Spring Boot 默認提供的錯誤處理器，負責處理 /error 請求。
@Controller
@RequestMapping("${server.error.path:${spring.mvc.async.request-timeout}}")
public class BasicErrorController extends AbstractErrorController {
...
}- 默認路徑為
/error（可通過server.error.path配置修改） - 支持兩種響應格式：
text/html：返回 HTML 錯誤頁面（如error.html）- 其他格式（如 JSON）：返回結(jié)構(gòu)化錯誤信息
2.ErrorAttributes接口
該接口定義了錯誤信息的內(nèi)容來源，包括：
- 異常對象
- HTTP 狀態(tài)碼
- 請求 URL
- 時間戳等
默認實現(xiàn)是 DefaultErrorAttributes，你也可以自定義。
3.ErrorViewResolver接口
用于解析 HTML 錯誤頁面。例如：
/templates/error/404.html/templates/error/5xx.html/templates/error.html
Spring Boot 會根據(jù)狀態(tài)碼優(yōu)先匹配具體頁面。
?? 三、默認返回的 JSON 錯誤結(jié)構(gòu)
當你訪問一個 REST 接口時，如果發(fā)生異常且沒有被 @ExceptionHandler 或 @ControllerAdvice 捕獲，Spring Boot 會返回如下格式的 JSON 響應：
{
"timestamp": "2025-07-12T10:45:00.000+00:00",
"status": 404,
"error": "Not Found",
"path": "/not-found"
}字段說明：
| 字段名 | 含義 |
|---|---|
| timestamp | 錯誤發(fā)生時間 |
| status | HTTP 狀態(tài)碼 |
| error | 錯誤描述 |
| exception | 異常類名（僅當 spring.boot.debug=true 時顯示） |
| message | 異常消息（可選） |
| path | 出錯的請求路徑 |
?? 四、如何自定義錯誤處理？
雖然 Spring Boot 提供了默認的錯誤處理機制，但在實際項目中我們通常需要進行定制：
1.方式一：自定義ErrorAttributes
你可以實現(xiàn) ErrorAttributes 接口來自定義錯誤信息內(nèi)容：
@Component
public class CustomErrorAttributes extends DefaultErrorAttributes {
@Override
public Map<String, Object> getErrorAttributes(WebRequest webRequest, ErrorAttributeOptions options) {
Map<String, Object> errorMap = super.getErrorAttributes(webRequest, options);
errorMap.put("customInfo", "This is a custom error info.");
return errorMap;
}
}2.方式二：繼承BasicErrorController自定義控制器
@RestController
@RequestMapping("${server.error.path:/error}")
public class CustomErrorController extends BasicErrorController {
public CustomErrorController(ErrorAttributes errorAttributes) {
super(errorAttributes, new ErrorProperties());
}
@Override
public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) {
Map<String, Object> body = getErrorAttributes(new ServletWebRequest(request), true);
return new ResponseEntity<>(body, HttpStatus.INTERNAL_SERVER_ERROR);
}
}3.方式三：創(chuàng)建自定義錯誤頁面（HTML）
將 HTML 頁面放在以下位置之一即可：
src/main/resources/templates/error/404.htmlsrc/main/resources/static/error/500.htmlsrc/main/resources/public/error.html
Spring Boot 會根據(jù) HTTP 狀態(tài)碼自動選擇對應的頁面。
4.方式四：使用@ControllerAdvice全局處理異常
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
public ResponseEntity<Map<String, Object>> handleException(Exception ex, HttpServletRequest request) {
Map<String, Object> errorBody = new HashMap<>();
errorBody.put("error", ex.getMessage());
errorBody.put("path", request.getRequestURI());
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(errorBody);
}
}這種方式比默認機制更靈活，適用于大型項目。
?? 五、配置相關(guān)屬性（application.yml）
你可以在 application.yml 或 application.properties 中配置一些與錯誤相關(guān)的參數(shù)：
spring:
mvc:
async:
request-timeout: 0 # 禁用超時控制
server:
error:
path: /my-error # 自定義錯誤路徑
whitelabel:
enabled: false # 關(guān)閉默認白標錯誤頁? 六、總結(jié)
| 項目 | 內(nèi)容 |
|---|---|
| 默認錯誤端點 | /error |
| 默認控制器 | BasicErrorController |
| 默認錯誤信息 | DefaultErrorAttributes |
| 默認視圖支持 | 支持 HTML 錯誤頁面（按狀態(tài)碼命名） |
| JSON 輸出格式 | 包含 timestamp, status, error, path 等字段 |
| 可擴展性 | 支持自定義 ErrorAttributes、ErrorController、HTML 頁面、@ControllerAdvice |
到此這篇關(guān)于SpringBoot中默認異常處理機制的實現(xiàn)的文章就介紹到這了,更多相關(guān)SpringBoot 默認異常處理機制內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
java實現(xiàn)一個簡單的網(wǎng)絡(luò)爬蟲代碼示例
這篇文章主要介紹了java實現(xiàn)一個簡單的網(wǎng)絡(luò)爬蟲代碼示例，還是挺不錯的，這里分享給大家，需要的朋友可以參考下。2017-11-11
Spring?Security自定義登錄頁面認證過程常用配置
這篇文章主要為大家介紹了Spring?Security自定義登錄頁面認證過程常用配置示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-08-08
這篇文章主要為大家詳細介紹了java使用Filter實現(xiàn)自動登錄的方法，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-04-04
Java高級之HashMap中的entrySet()方法使用
這篇文章主要介紹了Java高級之HashMap中的entrySet()方法使用，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-03-03
這篇文章主要介紹了Java經(jīng)典設(shè)計模式之策略模式,簡單說明了策略模式的概念、原理并結(jié)合實例形式分析了java策略模式的具有用法與相關(guān)注意事項,需要的朋友可以參考下2021-09-09
elasticsearch集群cluster主要功能詳細分析
這篇文章主要為大家介紹了elasticsearch集群cluster主要功能詳細分析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-04-04
使用Java生成JWT(JSON Web Token)的方法示例
在現(xiàn)代應用程序中,身份驗證和授權(quán)是至關(guān)重要的,JWT是一種簡單而強大的身份驗證和授權(quán)機制,可以在Web應用程序中安全地傳輸用戶信息,本文主要介紹了使用Java生成JWT的方法示例,感興趣的可以了解一下2024-03-03
springboot 整合 nacos 配置實現(xiàn)多個環(huán)境不同配置
本文介紹了Nacos配置中心的優(yōu)勢,包括與Apollo的性能對比,Nacos服務(wù)端的安裝與配置,以及如何在SpringBoot項目中集成Nacos進行多環(huán)境配置,提供了詳細的步驟,包括下載、安裝、配置中心的創(chuàng)建和項目集成,旨在幫助開發(fā)者更好地使用Nacos進行項目配置管理2024-09-09
Stream?API?是Java8中新加入的功能，這篇文章主要帶大家了解一下?Stream?API?中的?map()?方法的使用，感興趣的小伙伴可以跟隨小編一起學習一下2023-04-04
這篇文章主要介紹了druid ParserException類錯誤問題及解決方案,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-12-12