Spring MVC 中，優(yōu)雅處理異常的六種方式！
異常處理是每個(gè) Java程序員需要面對(duì)的一個(gè)問題，在Spring中，提供了多種機(jī)制來處理控制器拋出的異常，確保應(yīng)用程序在面對(duì)各種錯(cuò)誤情況時(shí)能夠優(yōu)雅地響應(yīng)。這篇文章，我們來詳細(xì)分析Spring MVC中，幾種優(yōu)雅處理異常的方式。
1. 使用@ExceptionHandler注解
@ExceptionHandler注解允許在單個(gè)Controller中定義處理特定異常的方法。當(dāng) Controller的方法拋出指定的異常時(shí)，Spring會(huì)調(diào)用相應(yīng)的處理方法。
如下示例，展示了如何在 Controller層優(yōu)雅處理異常：
@Controller
public class MyController {
@RequestMapping("/example")
public String example() {
// 可能拋出異常的業(yè)務(wù)邏輯
if (1/0) {
throw new CustomException("自定義異常發(fā)生");
}
return "success";
}
@ExceptionHandler(CustomException.class)
public ModelAndView handleCustomException(CustomException ex) {
ModelAndView mav = new ModelAndView();
mav.addObject("message", ex.getMessage());
mav.setViewName("errorPage");
return mav;
}
}優(yōu)點(diǎn)： 簡(jiǎn)單直觀，適用于單個(gè)控制器的異常處理。
缺點(diǎn)： 如果多個(gè)控制器需要相同的異常處理邏輯，需要在每個(gè)控制器中重復(fù)定義。
2. 使用@ControllerAdvice注解
@ControllerAdvice是一種全局的異常處理方式，可以應(yīng)用于所有 Controller。通過將異常處理邏輯集中在一個(gè)地方，可以避免代碼重復(fù)，提高維護(hù)性。
如下示例，展示了如何使用@ControllerAdvice優(yōu)雅處理全局異常：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(CustomException.class)
public ModelAndView handleCustomException(CustomException ex) {
ModelAndView mav = new ModelAndView();
mav.addObject("message", ex.getMessage());
mav.setViewName("errorPage");
return mav;
}
@ExceptionHandler(Exception.class)
public ModelAndView handleGeneralException(Exception ex) {
ModelAndView mav = new ModelAndView();
mav.addObject("message", "發(fā)生了一個(gè)錯(cuò)誤: " + ex.getMessage());
mav.setViewName("errorPage");
return mav;
}
}優(yōu)點(diǎn)：
- 全局統(tǒng)一管理異常處理邏輯。
- 代碼更清晰，易于維護(hù)。
缺點(diǎn)：
- 全局處理不適用于需要針對(duì)某些控制器有特殊處理需求的情況，需結(jié)合其他方法使用。
3. 實(shí)現(xiàn)HandlerExceptionResolver接口
HandlerExceptionResolver 是一種更底層的異常處理機(jī)制，通過實(shí)現(xiàn)該接口，開發(fā)者可以自定義異常解析邏輯。
如下示例，展示了如何實(shí)現(xiàn)HandlerExceptionResolver接口優(yōu)雅處理異常：
public class MyExceptionResolver implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest request,
HttpServletResponse response,
Object handler,
Exception ex) {
ModelAndView mav = new ModelAndView();
if (ex instanceof CustomException) {
mav.addObject("message", ex.getMessage());
mav.setViewName("customErrorPage");
} else {
mav.addObject("message", "未知錯(cuò)誤");
mav.setViewName("errorPage");
}
return mav;
}
}配置：
在 Spring 配置文件中注冊(cè)自定義異常解析器：
<bean class="com.example.MyExceptionResolver"/>優(yōu)點(diǎn)：
- 高度靈活，可以處理各種復(fù)雜的異常情景。
缺點(diǎn)：
- 需要更多的配置和實(shí)現(xiàn)工作。
- 不如注解方式直觀，適用性較低。
4. 使用@ResponseStatus注解
@ResponseStatus注解可以用于自定義異常對(duì)應(yīng)的 HTTP 狀態(tài)碼和錯(cuò)誤信息，當(dāng)拋出帶有該注解的異常時(shí)，Spring會(huì)自動(dòng)設(shè)置相應(yīng)的狀態(tài)碼。
如下示例，展示了如何使用@ResponseStatus注解優(yōu)雅處理異常：
@ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "資源未找到")
public class ResourceNotFoundException extends RuntimeException {
public ResourceNotFoundException(String message) {
super(message);
}
}使用：
@Controller
public class MyController {
@RequestMapping("/resource")
public String getResource() {
// 假設(shè)資源未找到
throw new ResourceNotFoundException("資源ID不存在");
}
}優(yōu)點(diǎn)：簡(jiǎn)單快捷，適用于直接映射到特定 HTTP 狀態(tài)碼的異常情況。
缺點(diǎn)：無法返回自定義的錯(cuò)誤頁面或更復(fù)雜的錯(cuò)誤信息。
5. 使用ResponseEntity和@RestControllerAdvice
在構(gòu)建 RESTful API時(shí)，常用ResponseEntity來返回自定義的錯(cuò)誤響應(yīng)，并結(jié)合@RestControllerAdvice可以全局處理異常并返回 JSON 格式的錯(cuò)誤信息。
如下示例，展示了如何使用ResponseEntity和@RestControllerAdvice來處理 RESTful API的異常：
@RestControllerAdvice
public class RestExceptionHandler {
@ExceptionHandler(CustomException.class)
public ResponseEntity<ErrorResponse> handleCustomException(CustomException ex) {
ErrorResponse error = new ErrorResponse("CUSTOM_ERROR", ex.getMessage());
return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
}
@ExceptionHandler(Exception.class)
public ResponseEntity<ErrorResponse> handleGeneralException(Exception ex) {
ErrorResponse error = new ErrorResponse("GENERAL_ERROR", "內(nèi)部服務(wù)器錯(cuò)誤");
return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
}
}
public class ErrorResponse {
private String errorCode;
private String errorMessage;
// 構(gòu)造方法、getter 和 setter
}優(yōu)點(diǎn)：
- 適用于 RESTful 服務(wù)，能夠返回結(jié)構(gòu)化的錯(cuò)誤信息（如 JSON）。
- 全局統(tǒng)一管理，易于維護(hù)。
缺點(diǎn)：
- 需要定義額外的錯(cuò)誤響應(yīng)類。
6. 使用@ControllerAdvice和@ExceptionHandler
如果使用 Spring Boot，可以更便捷地使用 @ControllerAdvice 結(jié)合自動(dòng)配置實(shí)現(xiàn)異常處理。
如下示例，展示了如何使用@ControllerAdvice和@ExceptionHandler來處理異常：
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<ValidationErrorResponse> handleValidationExceptions(
MethodArgumentNotValidException ex) {
ValidationErrorResponse errors = new ValidationErrorResponse();
ex.getBindingResult().getAllErrors().forEach((error) -> {
errors.addError(((FieldError) error).getField(), error.getDefaultMessage());
});
return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
}
// 其它異常處理方法
}優(yōu)點(diǎn)：
- 與 Spring Boot 無縫集成，減少配置。
- 提供了諸多便利的功能，如自動(dòng)處理驗(yàn)證錯(cuò)誤等。
總結(jié)
本文，我們分析了 Spring MVC優(yōu)雅處理異常的幾種方法以及代碼示例，我們可以根據(jù)具體需求選擇合適的方法：
- 局部控制器處理：使用 @ExceptionHandler 注解，適用于單個(gè)控制器的特定異常處理。
- 全局處理：使用 @ControllerAdvice 或 @RestControllerAdvice，適用于跨多個(gè)控制器的統(tǒng)一異常處理。
- 自定義解析：實(shí)現(xiàn) HandlerExceptionResolver 接口，適用于需要高度自定義的異常處理邏輯。
- 狀態(tài)碼注解：使用 @ResponseStatus 注解，適用于簡(jiǎn)單的異常狀態(tài)碼映射。
- RESTful API：結(jié)合 ResponseEntity 和全局異常處理，返回結(jié)構(gòu)化的錯(cuò)誤響應(yīng)。
從實(shí)際工作來看，@ControllerAdvice 或 @RestControllerAdvice是使用頻率最高的一種方式。
