效果演示

我們先來看一下Springboot的默認效果

瀏覽器訪問

客戶端訪問

劃重點?。?！

但是絕大部分公司的代碼，都是沒做自適應(yīng)處理的，很大一部分原因在于，你在網(wǎng)上搜索Springboot全局異常處理，都是搜索到這么一段代碼！

@ControllerAdvice
public?class?MyControllerAdvice?{
?
?
????@ResponseBody
????@ExceptionHandler(value?=?Exception.class)
????public?ResponseEntity?errorHandler(Exception?ex)?{
???????//?處理異常
????}

?
}

強烈建議先用自己常用的搜索引擎搜索一遍，然后再看一下自己公司代碼，看看是不是類似這么一段代碼再往下看。

當然很多同學可能會說，我們就已經(jīng)和客戶端約定很好了，只會有json,不會有返回html的場景。所以，不做這個適應(yīng)，其實也是沒問題的。但是如果你是做基礎(chǔ)架構(gòu)的同學，這個功能你是必須要做的，因為你對接的是整個公司的業(yè)務(wù)部門，Springboot能做，你做類似的基礎(chǔ)組件，如果功能比Springboot還差，你讓業(yè)務(wù)方的同學怎么想？

當然，對于絕大部分同學來說，不做問題也不大。

但是這樣你會錯過一個很好的學習機會。什么學習機會？因為很多同學平時總說，面試造火箭，工作中遇到不懂的問題百度或者谷歌一下就好了。然而，這個問題，你就沒這么好搜索到。也就是說，絕大部分人都是面向搜索引擎編程，當遇到搜索引擎無法解決的問題的時候，就是體現(xiàn)你價值的時候，好好珍惜。

做不做這個功能我覺得不重要，這個寶貴的鍛煉解決問題能力的機會是真的很難得，畢竟，確實大部分功能是真的簡單搜索，或者肥朝交流群問問就能解決。

自適應(yīng)原理

很多同學說，既然搜索不到，那果斷一波源碼走起。但是，Springboot源碼這么多，請問哪里入手？這個才是重點！這個時候，我們可以官方文檔走一波。

27.1.9 Error Handling

Spring Boot provides an /error mapping by default that handles all errors in a sensible way, and it is registered as a ‘global’ error page in the servlet container. For machine clients it will produce a JSON response with details of the error, the HTTP status and the exception message. For browser clients there is a ‘whitelabel’ error view that renders the same data in HTML format (to customize it just add a View that resolves to ‘error’). To replace the default behaviour completely you can implement ErrorController and register a bean definition of that type, or simply add a bean of type ErrorAttributes to use the existing mechanism but replace the contents.

一些同學說，英文看不懂？我挑5個重點單詞給你，都是小學單詞，只要小學能畢業(yè)，我認為都能看懂。

clients JSON browser HTML ErrorController

肥朝小聲逼逼：這里特別強調(diào)，并不是說看官方文檔是最優(yōu)解決問題方案。還是那句話，老司機都是看菜吃飯的，解決問題的套路有很多，時間有限，我就不把所有套路一個一個列出來（其實是怕套路全部告訴你們了，你們就取關(guān)了?。比胫黝}就行。

從文檔和小學的英文單詞我們把目標鎖定在了ErrorController，給大家看一下關(guān)鍵代碼

@Controller
@RequestMapping("${server.error.path:${error.path:/error}}")
public?class?BasicErrorController?extends?AbstractErrorController?{

?@RequestMapping(produces?=?"text/html")
?public?ModelAndView?errorHtml(HttpServletRequest?request,
???HttpServletResponse?response)?{
??HttpStatus?status?=?getStatus(request);
??Map?model?=?Collections.unmodifiableMap(getErrorAttributes(
????request,?isIncludeStackTrace(request,?MediaType.TEXT_HTML)));
??response.setStatus(status.value());
??ModelAndView?modelAndView?=?resolveErrorView(request,?response,?status,?model);
??return?(modelAndView?!=?null)???modelAndView?:?new?ModelAndView("error",?model);
?}

?@RequestMapping
?@ResponseBody
?public?ResponseEntity>?error(HttpServletRequest?request)?{
??Map?body?=?getErrorAttributes(request,
????isIncludeStackTrace(request,?MediaType.ALL));
??HttpStatus?status?=?getStatus(request);
??return?new?ResponseEntity>(body,?status);
?}

}

從這里我們大致可以猜測出，要做一個自適應(yīng)的全局異常處理，理論上是要這么寫的。

@ControllerAdvice
public?class?MyExceptionHandler??{

????@ExceptionHandler(Exception.class)
????public?String?handleExceptionHtml(Exception?e,?HttpServletRequest?httpServletRequest)?{
????????//?這里做一些你自己的處理，比如
????????httpServletRequest.setAttribute("歡迎關(guān)注微信公眾號","肥朝");
????????return?"forward:/error";
????}

}

果然調(diào)試一波，發(fā)現(xiàn)果真如此。當然具體怎么自定義這個錯誤界面之類的，網(wǎng)上一搜就有，所以這些不是肥朝的重點。那么這個自適應(yīng)全局異常似乎美滋滋了？

遇到問題

我們知道了這個自適應(yīng)的全局異常處理的原理，也很容易想到怎么弄出bug。比如，你在攔截器出現(xiàn)了異常的話。

@Configuration
public?class?MyMvcConfig?extends?WebMvcConfigurerAdapter?{

????@Override
????public?void?addInterceptors(InterceptorRegistry?registry)?{
????????registry.addInterceptor(new?HandlerInterceptor()?{
????????????@Override
????????????public?boolean?preHandle(HttpServletRequest?httpServletRequest,?HttpServletResponse?httpServletResponse,?Object?o)?throws?Exception?{
????????????????throw?new?RuntimeException("這里假裝拋出一個肥朝異常");
????????????????//return?true;
????????????}

????????????@Override
????????????public?void?postHandle(HttpServletRequest?httpServletRequest,?HttpServletResponse?httpServletResponse,?Object?o,?ModelAndView?modelAndView)?throws?Exception?{

????????????}

????????????@Override
????????????public?void?afterCompletion(HttpServletRequest?httpServletRequest,?HttpServletResponse?httpServletResponse,?Object?o,?Exception?e)?throws?Exception?{

????????????}
????????});
????}

}

那么就會出現(xiàn)，StackOverflowError。

因為攔截器出現(xiàn)異常，會掉進你的全局異常處理，然后你的全局異常處理，又進行forward，又進入了攔截器，然后一直循環(huán)。

那么怎么解決這個問題呢？我們見招拆招，這個時候，我要演示常見的幾種不優(yōu)雅，但是平時大家都容易做的寫法。

將配置寫死

registry.addInterceptor(new?HandlerInterceptor()?{
????@Override
????public?boolean?preHandle(HttpServletRequest?httpServletRequest,?HttpServletResponse?httpServletResponse,?Object?o)?throws?Exception?{
????????throw?new?RuntimeException("這里假裝拋出一個肥朝異常");
????????//return?true;
????}

????@Override
????public?void?postHandle(HttpServletRequest?httpServletRequest,?HttpServletResponse?httpServletResponse,?Object?o,?ModelAndView?modelAndView)?throws?Exception?{

????}

????@Override
????public?void?afterCompletion(HttpServletRequest?httpServletRequest,?HttpServletResponse?httpServletResponse,?Object?o,?Exception?e)?throws?Exception?{

????}
}).excludePathPatterns("/error");

我們從

@RequestMapping("${server.error.path:${error.path:/error}}")

這里得知，這個error.path是可以配置的，很多同學圖快，excludePathPatterns處寫死了/error，這樣一直用默認的自然沒問題，一旦人家配置了error.path，就出問題了。

潛規(guī)則

這個潛規(guī)則的問題，是絕大部分同學寫代碼中最常見的問題。你想一下，你的自適應(yīng)全局異常是解決了，但是，帶來的影響卻是，每一個攔截器都要加上excludePathPatterns這么一個配置。對于使用者來說，這個必須加上某個配置，就是一種潛規(guī)則，而且，對于新來的同事而言，他根本不知道這種潛規(guī)則，一旦潛規(guī)則的代碼多了，后續(xù)很難維護。

拓展思考

那么不潛規(guī)則的代碼應(yīng)該是怎么樣的？

當然很多時候，我們必須要潛規(guī)則！比如，大數(shù)據(jù)的同學要求，送過來的日志一定要有應(yīng)用名。那么，對于業(yè)務(wù)方而言，他就必須要配置應(yīng)用名。那么，如何讓業(yè)務(wù)方的同事知道這個潛規(guī)則。當然很多同學說，那就直接告訴同事要加某些參數(shù)啊。你連肥朝每天的推文都不記得看，你能保證每個同事都記得？

所以總結(jié)下來，我們遇到這么一類問題如下：

1.我們需要對攔截器進行一些潛規(guī)則參數(shù)，比如本文這種，如何優(yōu)雅潛規(guī)則？

2.比如攔截器有順序要求，比如我們基礎(chǔ)框架定義了一個traceInterceptor的攔截器，這個攔截器就必須放在最前。那么問題來了，你怎么保證這個是最前的。有同學就說了，那我用@Order控制啊。那我也寫一個和你一樣的攔截器，叫feichaoInterceptor,代碼和你一模一樣，既然一模一樣，你怎么保證你的就比我的前了？

3.對于必須要潛規(guī)則的場景，如何在反抗的情況下，也能潛到？

對于這幾個問題，我們下期再解答。