Spring Boot 中的默認異常處理機制解析(如 /error 接口)
更新時間：2025年07月17日 10:23:42 作者：南姜先生
SpringBoot通過/error接口默認處理異常,使用BasicErrorController返回結(jié)構(gòu)化JSON或HTML錯誤頁面,支持自定義ErrorAttributes、ControllerAdvice及錯誤模板,配置項可調(diào)整錯誤路徑和格式,本文給大家介紹Spring Boot 中的默認異常處理機制解析,感興趣的朋友一起看看吧
在 Spring Boot 中，為了簡化 Web 應(yīng)用的異常處理流程，它提供了一套默認的全局異常處理機制，其中最核心的就是 /error 接口。這個接口是 Spring Boot 提供的一個內(nèi)置錯誤頁面控制器（BasicErrorController），用于統(tǒng)一返回錯誤信息。
?? 一句話總結(jié)：
? Spring Boot 默認使用
BasicErrorController來處理所有未被捕獲的異常，并通過/error接口返回結(jié)構(gòu)化的錯誤響應(yīng)或跳轉(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 默認提供的錯誤處理器，負責(zé)處理 /error 請求。
@Controller
@RequestMapping("${server.error.path:${spring.mvc.async.request-timeout}}")
public class BasicErrorController extends AbstractErrorController {
...
}- 默認路徑為
/error（可通過server.error.path配置修改） - 支持兩種響應(yīng)格式：
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)
當(dāng)你訪問一個 REST 接口時，如果發(fā)生異常且沒有被 @ExceptionHandler 或 @ControllerAdvice 捕獲，Spring Boot 會返回如下格式的 JSON 響應(yīng)：
{
"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 | 異常類名（僅當(dāng) 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)碼自動選擇對應(yīng)的頁面。
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)閉默認白標(biāo)錯誤頁? 六、總結(jié)
| 項目 | 內(nèi)容 |
|---|---|
| 默認錯誤端點 | /error |
| 默認控制器 | BasicErrorController |
| 默認錯誤信息 | DefaultErrorAttributes |
| 默認視圖支持 | 支持 HTML 錯誤頁面（按狀態(tài)碼命名） |
| JSON 輸出格式 | 包含 timestamp, status, error, path 等字段 |
| 可擴展性 | 支持自定義 ErrorAttributes、ErrorController、HTML 頁面、@ControllerAdvice |
到此這篇關(guān)于Spring Boot 中的默認異常處理機制（如 /error 接口）的文章就介紹到這了,更多相關(guān)Spring Boot 異常處理內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
本文主要介紹了Java實現(xiàn)非對稱加密的三種方法,主要包括非對稱加密算法--DH（密鑰交換）,非對稱加密算法--RSA,非對稱加密算法--EIGamal,具有一定的參考價值,感興趣的可以了解一下2023-12-12
Nacos提供多種負載均衡策略,包括權(quán)重、同機房、同地域、同環(huán)境等,服務(wù)下線和權(quán)重配置可以通過Nacos管理界面進行,同時,Nacos使用Raft算法選舉Leader節(jié)點,若IP地址改變可能會影響Leader選舉,配置同集群優(yōu)先訪問可以提高訪問速度,通過配置集群名稱和負載均衡策略2025-03-03
今天帶大家學(xué)習(xí)Java常用工具類,文中有非常詳細的圖文解說及代碼示例,對正在學(xué)習(xí)java的小伙伴們很有幫助,需要的朋友可以參考下，希望能給你帶來幫助2021-07-07
這篇文章主要為大家詳細介紹了Java?Cloneable接口的深拷貝與淺拷貝，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下，希望能夠給你帶來幫助2022-03-03
mybatis中使用sqlMap進行sql查詢時,經(jīng)常需要動態(tài)傳遞參數(shù),在動態(tài)SQL解析階段, #{ } 和 ${ } 會有不同的表現(xiàn),這篇文章主要給大家介紹了關(guān)于mybatis中${}和#{}取值區(qū)別的相關(guān)資料,需要的朋友可以參考下2021-09-09
這篇文章主要介紹了Java設(shè)計模式之抽象工廠模式詳解,文中有非常詳細的代碼示例,對正在學(xué)習(xí)java的小伙伴們有非常好的幫助,需要的朋友可以參考下2021-05-05
常用json與javabean互轉(zhuǎn)的方法實現(xiàn)
這篇文章主要介紹了常用json與javabean互轉(zhuǎn)的方法實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-04-04
這篇文章主要介紹了基于SpringBoot實現(xiàn)大文件分塊上傳功能,實現(xiàn)原理其實很簡單,核心就是客戶端把大文件按照一定規(guī)則進行拆分,比如20MB為一個小塊,分解成一個一個的文件塊,然后把這些文件塊單獨上傳到服務(wù)端,需要的朋友可以參考下2024-09-09
這篇文章主要介紹了Spring自定義注解配置簡單日志示例,注解可以增強我們的java代碼，同時利用反射技術(shù)可以擴充實現(xiàn)很多功能,它們被廣泛應(yīng)用于三大框架底層,需要的朋友可以參考下2023-05-05
這篇文章主要介紹了Java URL編碼與解碼基礎(chǔ)詳解,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-06-06