SpringBoot處理全局統(tǒng)一異常的實(shí)現(xiàn)
在后端發(fā)生異常或者是請(qǐng)求出錯(cuò)時(shí),前端通常顯示如下
Whitelabel Error PageThis application has no explicit mapping for /error, so you are seeing this as a fallback.
Fri Jun 07 15:38:07 CST 2019There was an unexpected error (type=Not Found, status=404).No message available
對(duì)于用戶(hù)來(lái)說(shuō)非常不友好。
本文主要講解如何在SpringBoot應(yīng)用中使用統(tǒng)一異常處理。
實(shí)現(xiàn)方式
第一種:使用@ControllerAdvice和@ExceptionHandler注解 第二種: 使用ErrorController類(lèi)來(lái)實(shí)現(xiàn)。第一種:使用@ControllerAdvice和@ExceptionHandler注解
@Slf4j@ControllerAdvicepublic class GlobalExceptionHandler { @ResponseBody @ExceptionHandler(NullPointerException.class) public BaseResult globalException(HttpServletResponse response,NullPointerException ex){ log.info('GlobalExceptionHandler...');log.info('錯(cuò)誤代碼:' + response.getStatus());BaseResult result = new WebResult(WebResult.RESULT_FAIL,'request error:'+response.getStatus() ,'GlobalExceptionHandler:'+ex.getMessage()); return result;}}
注解@ControllerAdvice表示這是一個(gè)控制器增強(qiáng)類(lèi),當(dāng)控制器發(fā)生異常且符合類(lèi)中定義的攔截異常類(lèi),將會(huì)被攔截。
可以定義攔截的控制器所在的包路徑
@Target({ElementType.TYPE})@Retention(RetentionPolicy.RUNTIME)@Documented@Componentpublic @interface ControllerAdvice { @AliasFor('basePackages') String[] value() default {}; @AliasFor('value') String[] basePackages() default {}; Class<?>[] basePackageClasses() default {}; Class<?>[] assignableTypes() default {}; Class<? extends Annotation>[] annotations() default {};}
注解ExceptionHandler定義攔截的異常類(lèi)
@Target({ElementType.METHOD})@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface ExceptionHandler { Class<? extends Throwable>[] value() default {};}
第二種: 使用ErrorController類(lèi)來(lái)實(shí)現(xiàn)。
系統(tǒng)默認(rèn)的錯(cuò)誤處理類(lèi)為BasicErrorController,將會(huì)顯示如上的錯(cuò)誤頁(yè)面。
這里編寫(xiě)一個(gè)自己的錯(cuò)誤處理類(lèi),上面默認(rèn)的處理類(lèi)將不會(huì)起作用。
getErrorPath()返回的路徑服務(wù)器將會(huì)重定向到該路徑對(duì)應(yīng)的處理類(lèi),本例中為error方法。
@Slf4j@RestControllerpublic class HttpErrorController implements ErrorController { private final static String ERROR_PATH = '/error'; @ResponseBody @RequestMapping(path = ERROR_PATH ) public BaseResult error(HttpServletRequest request, HttpServletResponse response){ log.info('訪問(wèn)/error' + ' 錯(cuò)誤代碼:' + response.getStatus()); BaseResult result = new WebResult(WebResult.RESULT_FAIL,'HttpErrorController error:'+response.getStatus());return result; } @Override public String getErrorPath() { return ERROR_PATH; }}
測(cè)試
以上定義了一個(gè)統(tǒng)一的返回類(lèi)BaseResult,方便前端進(jìn)行處理。
package com.microblog.common.result;import java.io.Serializable;public class BaseResult implements Serializable { private static final long serialVersionUID = 1L; public static final int RESULT_FAIL = 0; public static final int RESULT_SUCCESS = 1; //返回代碼 private Integer code; //返回消息 private String message; //返回對(duì)象 private Object data; public BaseResult(Integer code, String message) { this.code = code; this.message = message; } public BaseResult(Integer code, String message, Object object) { this.code = code; this.message = message; this.data = object; } public Integer getCode() { return code; } public void setCode(Integer code) { this.code = code; } public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } public Object getData() { return data; } public void setData(Object data) { this.data = data; }}
編寫(xiě)一個(gè)測(cè)試控制器
@Slf4j@RestController@RequestMapping('/user')public class TestController { @RequestMapping('/info1') public String test(){ log.info('/user/info1'); throw new NullPointerException('TestController have exception'); }}
1.發(fā)出一個(gè)錯(cuò)誤的請(qǐng)求,也就是沒(méi)有對(duì)應(yīng)的處理類(lèi)。
從返回可以看到是由HttpErrorController類(lèi)處理
{'code':0,'message':'HttpErrorController error:404','data':null}
2.發(fā)出一個(gè)正常的請(qǐng)求(TestController的test()處理),處理類(lèi)中拋出空異樣
從返回中可以看出是由GlobalExceptionHandler類(lèi)處理
{'code':0,'message':'request error:200','data':'GlobalExceptionHandler:TestController have exception'}
區(qū)別
1.注解@ControllerAdvice方式只能處理控制器拋出的異常。此時(shí)請(qǐng)求已經(jīng)進(jìn)入控制器中。
2.類(lèi)ErrorController方式可以處理所有的異常,包括未進(jìn)入控制器的錯(cuò)誤,比如404,401等錯(cuò)誤
3.如果應(yīng)用中兩者共同存在,則@ControllerAdvice方式處理控制器拋出的異常,類(lèi)ErrorController方式未進(jìn)入控制器的異常。
4.@ControllerAdvice方式可以定義多個(gè)攔截方法,攔截不同的異常類(lèi),并且可以獲取拋出的異常信息,自由度更大。
到此這篇關(guān)于SpringBoot處理全局統(tǒng)一異常的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)SpringBoot 全局統(tǒng)一異常內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. ASP的Global.asa文件技巧用法2. CSS3實(shí)例分享之多重背景的實(shí)現(xiàn)(Multiple backgrounds)3. ASP中if語(yǔ)句、select 、while循環(huán)的使用方法4. ASP中常用的22個(gè)FSO文件操作函數(shù)整理5. SharePoint Server 2019新特性介紹6. 告別AJAX實(shí)現(xiàn)無(wú)刷新提交表單7. Vue+elementUI下拉框自定義顏色選擇器方式8. PHP函數(shù)原理理解詳談9. XML入門(mén)的常見(jiàn)問(wèn)題(四)10. 使用css實(shí)現(xiàn)全兼容tooltip提示框
