在 Spring Boot 中，為了簡(jiǎn)化 Web 應(yīng)用的異常處理流程，它提供了一套默認(rèn)的全局異常處理機(jī)制，其中最核心的就是 /error 接口。這個(gè)接口是 Spring Boot 提供的一個(gè)內(nèi)置錯(cuò)誤頁(yè)面控制器（BasicErrorController），用于統(tǒng)一返回錯(cuò)誤信息。

?? 一句話總結(jié)：

? Spring Boot 默認(rèn)使用 BasicErrorController 來(lái)處理所有未被捕獲的異常，并通過(guò) /error 接口返回結(jié)構(gòu)化的錯(cuò)誤響應(yīng)或跳轉(zhuǎn)到錯(cuò)誤頁(yè)面（如 HTML 頁(yè)面）。

?? 一、默認(rèn)行為概覽

例如：

• 訪問(wèn)一個(gè)不存在的路徑：GET /not-found
• 控制器拋出未處理的異常 都會(huì)被 Spring Boot 的 /error 端點(diǎn)捕獲并處理。

??? 二、核心組件解析

1. BasicErrorController

這是 Spring Boot 默認(rèn)提供的錯(cuò)誤處理器，負(fù)責(zé)處理 /error 請(qǐng)求。

@Controller
@RequestMapping("${server.error.path:${spring.mvc.async.request-timeout}}")
public class BasicErrorController extends AbstractErrorController {
    ...
}

• 默認(rèn)路徑為 /error（可通過(guò) server.error.path 配置修改）
• 支持兩種響應(yīng)格式：
  • text/html：返回 HTML 錯(cuò)誤頁(yè)面（如 error.html）
  • 其他格式（如 JSON）：返回結(jié)構(gòu)化錯(cuò)誤信息

2. ErrorAttributes 接口

該接口定義了錯(cuò)誤信息的內(nèi)容來(lái)源，包括：

• 異常對(duì)象
• HTTP 狀態(tài)碼
• 請(qǐng)求 URL
• 時(shí)間戳等

默認(rèn)實(shí)現(xiàn)是 DefaultErrorAttributes，你也可以自定義。

3. ErrorViewResolver 接口

用于解析 HTML 錯(cuò)誤頁(yè)面。例如：

• /templates/error/404.html
• /templates/error/5xx.html
• /templates/error.html

Spring Boot 會(huì)根據(jù)狀態(tài)碼優(yōu)先匹配具體頁(yè)面。

?? 三、默認(rèn)返回的 JSON 錯(cuò)誤結(jié)構(gòu)

當(dāng)你訪問(wèn)一個(gè) REST 接口時(shí)，如果發(fā)生異常且沒(méi)有被 @ExceptionHandler 或 @ControllerAdvice 捕獲，Spring Boot 會(huì)返回如下格式的 JSON 響應(yīng)：

{
  "timestamp": "2025-07-12T10:45:00.000+00:00",
  "status": 404,
  "error": "Not Found",
  "path": "/not-found"
}

字段說(shuō)明：

?? 四、如何自定義錯(cuò)誤處理？

雖然 Spring Boot 提供了默認(rèn)的錯(cuò)誤處理機(jī)制，但在實(shí)際項(xiàng)目中我們通常需要進(jìn)行定制：

1. 方式一：自定義 ErrorAttributes

你可以實(shí)現(xiàn) ErrorAttributes 接口來(lái)自定義錯(cuò)誤信息內(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)建自定義錯(cuò)誤頁(yè)面（HTML）

將 HTML 頁(yè)面放在以下位置之一即可：

• src/main/resources/templates/error/404.html
• src/main/resources/static/error/500.html
• src/main/resources/public/error.html

Spring Boot 會(huì)根據(jù) HTTP 狀態(tài)碼自動(dòng)選擇對(duì)應(yīng)的頁(yè)面。

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);
    }
}

這種方式比默認(rèn)機(jī)制更靈活，適用于大型項(xiàng)目。

?? 五、配置相關(guān)屬性（application.yml）

你可以在 application.yml 或 application.properties 中配置一些與錯(cuò)誤相關(guān)的參數(shù)：

spring:
  mvc:
    async:
      request-timeout: 0 # 禁用超時(shí)控制
server:
  error:
    path: /my-error     # 自定義錯(cuò)誤路徑
    whitelabel:
      enabled: false    # 關(guān)閉默認(rèn)白標(biāo)錯(cuò)誤頁(yè)

? 六、總結(jié)

到此這篇關(guān)于Spring Boot 中的默認(rèn)異常處理機(jī)制（如 /error 接口）的文章就介紹到這了,更多相關(guān)Spring Boot 異常處理內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論