深入理解spring-boot中的whitelabelerrorpage

一、白標籤錯誤頁面——為什麼是它？

在使用spring-boot進行web應用程序開發過程中，肯定會遇到頁面錯誤的情況，比如說404、500等錯誤。這時，我們會看到一個由spring-boot提供的默認錯誤頁面，通常稱為「whitelabelerrorpage」（白標籤錯誤頁面）。那麼為什麼是它呢？

首先，spring-boot決定使用默認的白標籤錯誤頁面的優勢在於方便，它就像一個萬能葯，能夠處理各種錯誤情況並且具有可擴展性。而且，白標籤錯誤頁面是一個配置了許多基本錯誤處理機制的模板，可以輕鬆地自定義錯誤頁面，減少大量重複工作。

其次，spring-boot的設計哲學——「輕量，靈活，自適應」也是使用默認的白標籤錯誤頁面的重要原因之一，使用白標籤錯誤頁面可以減少不必要的資源佔用，讓應用程序儘可能保持輕量化。

二、白標籤錯誤頁面——使用方法

要使用默認的白標籤錯誤頁面，不需要加任何配置，只需在spring-boot項目中引發錯誤即可。如果發生錯誤，就會自動顯示錯誤頁面，無需像傳統的web應用程序那樣在web.xml文件中進行配置。

然而，這裡還有一個小技巧——如果您想完全定製自己的錯誤處理機制，您可以將錯誤模板文件放置在class path路徑的「/error」 子目錄下，例如「/resources/error/404.html」，這樣當您的應用程序遇到錯誤時，將自動使用您的自定義模板而不是默認的白標籤錯誤頁面。

    /resources
      --- /error
            --- 404.html
            --- 500.html

三、白標籤錯誤頁面——細節注意

當您想要在錯誤頁面中迭代錯誤數據時，請注意，spring-boot默認提供的ModelAndView對象實際上是一個錯誤屬性Map類型的封裝器，其中包含錯誤的詳細信息。在模板的上下文中，可以通過thymeleaf表達式語言來訪問這些錯誤屬性。

儘管spring-boot為我們提供了方便的默認白標籤錯誤頁面，但是在開發過程中，我們仍需要考慮異常的處理方式，否則簡單的錯誤頁面是無法滿足我們的需求的。我們可以使用@ControllerAdvice註解來定義一個全局異常處理器來捕獲未處理異常。這可以確保任何未處理的異常都有一個地方來處理。示例如下：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ModelAndView handleException(HttpServletRequest request, Exception ex) {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("exception", ex);
        modelAndView.addObject("url", request.getRequestURL());
        modelAndView.setViewName("error");
        return modelAndView;
    }
}

在以上代碼中，我們定義了一個全局異常處理器，在應用程序中的所有@Controller類中都適用。該處理器將Exception對象傳遞給它，並使用您定義的自定義錯誤模板「error」進行渲染，同時在模板上下文中添加了請求的URL和異常對象屬性。

四、白標籤錯誤頁面——總結

藉助白標籤錯誤頁面，我們可以方便地為spring-boot項目提供默認的錯誤處理機制並提高我們的開發效率。如果我們想要進行自定義，只需要將自己的錯誤模板放在「/error」目錄中即可。在處理異常時，我們可以全局性地捕獲未處理的異常，並使用自己的自定義錯誤模板進行渲染。這使得spring-boot應用程序的錯誤處理變得更加靈活方便。