快捷導(dǎo)航

詳解Spring?MVC優(yōu)雅處理異常的6種方式

更新時(shí)間：2024年12月19日 08:25:11 作者：猿java

在Spring中提供了多種機(jī)制來(lái)處理控制器拋出的異常,確保應(yīng)用程序在面對(duì)各種錯(cuò)誤情況時(shí)能夠優(yōu)雅地響應(yīng),本文我們來(lái)詳細(xì)分析Spring?MVC中6種優(yōu)雅處理異常的方式,需要的可以參考下

異常處理是每個(gè) Java程序員需要面對(duì)的一個(gè)問(wèn)題，在Spring中，提供了多種機(jī)制來(lái)處理控制器拋出的異常，確保應(yīng)用程序在面對(duì)各種錯(cuò)誤情況時(shí)能夠優(yōu)雅地響應(yīng)。這篇文章，我們來(lái)詳細(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。通過(guò)將異常處理邏輯集中在一個(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ī)制，通過(guò)實(shí)現(xiàn)該接口，開(kāi)發(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)：

無(wú)法返回自定義的錯(cuò)誤頁(yè)面或更復(fù)雜的錯(cuò)誤信息。

5. 使用ResponseEntity和@RestControllerAdvice

在構(gòu)建 RESTful API時(shí)，常用ResponseEntity來(lái)返回自定義的錯(cuò)誤響應(yīng)，并結(jié)合@RestControllerAdvice可以全局處理異常并返回 JSON 格式的錯(cuò)誤信息。

如下示例，展示了如何使用ResponseEntity和@RestControllerAdvice來(lái)處理 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)類(lèi)。

6. 使用@ControllerAdvice和@ExceptionHandler

如果使用 Spring Boot，可以更便捷地使用 @ControllerAdvice 結(jié)合自動(dòng)配置實(shí)現(xiàn)異常處理。

如下示例，展示了如何使用@ControllerAdvice和@ExceptionHandler來(lái)處理異常：

@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 無(wú)縫集成，減少配置。
提供了諸多便利的功能，如自動(dòng)處理驗(yàn)證錯(cuò)誤等。

7. 總結(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)。