在日常工作中，我們通常會是使用 @ExceptionHandler注解來處理控制器（Controller）層面的異常，從而提高代碼的可維護性和復用性。那么，@ExceptionHandler注解是如何工作的？我們需要注意什么？這篇文章，我們來看一道得物的面試題。

1. 主要作用

首先，我們來看看@ExceptionHandler注解的源碼，截圖如下：

通過源碼，我們可以看到@ExceptionHandler注解只能用于方法上。從整體上看，@ExceptionHandler注解的作用主要有下面兩點：

• 局部異常處理：在單個控制器類中使用@ExceptionHandler，只對該控制器內部的方法拋出的異常進行處理。這種方式適用于特定控制器需要獨立處理某些異常的場景。
• 全局異常處理：結合@ControllerAdvice注解，可以定義全局的異常處理邏輯，適用于整個應用程序中所有控制器拋出的異常。這種方式有助于統一的異常處理機制，避免在每個控制器中重復編寫異常處理代碼。

使用@ExceptionHandler注解的好處有下面幾點：

• 代碼簡潔：將異常處理邏輯與業務邏輯分離，避免在每個控制器方法中重復編寫異常處理代碼。
• 可維護性強：集中管理異常處理邏輯，便于修改和擴展。
• 靈活性高：支持局部和全局的異常處理，滿足不同場景下的需求。

2. 原理

@ExceptionHandler的實現基于Spring的異常處理機制，主要涉及以下幾個關鍵組件：

• 異常解析器（HandlerExceptionResolver）：Spring MVC使用HandlerExceptionResolver接口來解析控制器方法拋出的異常。@ExceptionHandler是通過這種解析機制實現的。
• 反射機制：當控制器方法拋出異常時，Spring會掃描該控制器類中帶有@ExceptionHandler注解的方法，匹配異常類型，找到合適的異常處理方法。

匹配策略：

• 局部優先：首先查找當前控制器內帶有@ExceptionHandler注解的方法，匹配異常類型，執行相應的處理邏輯。
• 全局處理：如果當前控制器沒有匹配的@ExceptionHandler方法，則會查找使用@ControllerAdvice注解的類中定義的全局異常處理方法。
• 默認處理：如果沒有找到任何匹配的異常處理方法，Spring會使用其默認的異常處理機制，通常會返回一個錯誤頁面或錯誤響應。

3. 使用方法

在控制器類中定義帶有@ExceptionHandler注解的方法，示例如下：

@Controller
publicclass TestController {

    @RequestMapping("/tes")
    public String example() {
        // 可能拋出異常的業務邏輯
        if (someCondition) {
            thrownew CustomException("自定義異常發生");
        }
        return"success";
    }

    @ExceptionHandler(CustomException.class)
    public ModelAndView handleCustomException(CustomException ex) {
        ModelAndView mav = new ModelAndView("errorView");
        mav.addObject("message", ex.getMessage());
        return mav;
    }
}

在上述示例中，當/test請求處理方法拋出CustomException時，handleCustomException方法會被調用，返回一個指向errorView視圖的ModelAndView對象，并將異常信息傳遞給視圖。

另外，我們可以通過結合@ControllerAdvice和@ExceptionHandler兩個注解，可以實現全局異常處理，示例如下：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ModelAndView handleAllExceptions(Exception ex) {
        ModelAndView mav = new ModelAndView("globalErrorView");
        mav.addObject("message", ex.getMessage());
        return mav;
    }
}

這樣，無論哪個控制器拋出Exception或其子類異常，handleAllExceptions方法都會處理這些異常，從而實現統一的異常處理邏輯。

4. 注意事項

盡管@ExceptionHandler注解在Spring中提供了一種優雅而高效的方式來處理應用中的異常，但是在使用的過程中，我們也需要注意以下幾點：

• @ExceptionHandler方法的返回值可以是ModelAndView、ResponseEntity，或直接返回視圖名稱，具體取決于應用的需求。
• 異常處理方法可以接收異常對象作為參數，也可以接收其他與請求相關的參數，如HttpServletRequest、HttpServletResponse等。
• 在使用全局異常處理時，應合理定義異常層次結構和處理策略，以確保不同類型的異常得到正確的處理。

5. 總結

本文，我們分析了@ExceptionHandler注解的使用方法，了解了@ExceptionHandler注解在Spring中的作用，以及它的優勢和注意事項。在實際工作中，我們可以使用@ExceptionHandler注解更優雅地處理異常。