快捷導(dǎo)航

Springboot之自定義全局異常處理的實(shí)現(xiàn)

更新時(shí)間：2019年08月28日 14:07:42 作者：韓數(shù)

這篇文章主要介紹了Springboot之自定義全局異常處理的實(shí)現(xiàn),文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

前言：

在實(shí)際的應(yīng)用開(kāi)發(fā)中，很多時(shí)候往往因?yàn)橐恍┎豢煽氐囊蛩貙?dǎo)致程序出現(xiàn)一些錯(cuò)誤，這個(gè)時(shí)候就要及時(shí)把異常信息反饋給客戶(hù)端，便于客戶(hù)端能夠及時(shí)地進(jìn)行處理，而針對(duì)代碼導(dǎo)致的異常，我們一般有兩種處理方式，一種是throws直接拋出，一種是使用try..catch捕獲，一般的話(huà)，如果邏輯的異常，需要知道異常信息，我們往往選擇將異常拋出，如果只是要保證程序在出錯(cuò)的情況下依然可以繼續(xù)運(yùn)行，則使用try..catch來(lái)捕獲。

但是try..catch會(huì)導(dǎo)致代碼量的增加,讓后期我們的代碼變得臃腫且難以維護(hù)。當(dāng)然，springboot作為一個(gè)如此優(yōu)秀的框架，肯定不會(huì)坐視不管的，通過(guò)springboot自帶的注解，我們可以方便的自定義我們的全局異常處理器，并且以json格式返回給我們的客戶(hù)端。

代碼實(shí)戰(zhàn)：

捕獲全局異常：

首先呢，我們新建我們負(fù)責(zé)全局異常捕捉處理的類(lèi):MyControllerAdvice，代碼如下:

@ControllerAdvice
public class MyControllerAdvice {


  @ResponseBody
  @ExceptionHandler(value = Exception.class)
  public Map<String,Object> exceptionHandler(Exception ex){
    Map<String,Object> map = new HashMap<String,Object>();
    map.put("code",100);
    map.put("msg",ex.getMessage());
    //這里可以加上我們其他的異常處理代碼，比如日志記錄，，，
    return map;
  }

}

注解說(shuō)明：
@ControllerAdvice 通過(guò)AOP的方式配合@ExceptionHandler()注解捕獲在Controller層面發(fā)生的異常。如果需要掃描自定路徑下的Controller，添加basePackages屬性

@ControllerAdvice(basePackages ="com.example.demo.controller")

@RestControllerAdvice : 和@ControllerAdvice作用相同，可以理解為 @ResponseBody+@ControllerAdvice 的組合使用。

@ExceptionHandler()：該注解作用主要在于聲明一個(gè)或多個(gè)類(lèi)型的異常，當(dāng)符合條件的Controller拋出這些異常之后將會(huì)對(duì)這些異常進(jìn)行捕獲，然后按照其標(biāo)注的方法的邏輯進(jìn)行處理，從而改變返回的視圖信息。

測(cè)試：

@RestController
public class UserController {


  @GetMapping("/test")
  public String test(){
    int num = 1/0;
    return "Hello World";
  }
}

結(jié)果：

{"msg":"/ by zero","code":100}

捕獲自定義異常：

自定義我們的異常信息類(lèi)MyException 并繼承RuntimeException：

public class MyException extends RuntimeException {

  private String errorCode;
  private String errorMsg;

  public MyException(String errorCode, String errorMsg) {
    this.errorCode = errorCode;
    this.errorMsg = errorMsg;
  }


  public String getErrorCode() {
    return errorCode;
  }

  public void setErrorCode(String errorCode) {
    this.errorCode = errorCode;
  }

  public String getErrorMsg() {
    return errorMsg;
  }

  public void setErrorMsg(String errorMsg) {
    this.errorMsg = errorMsg;
  }
  
}

修改我們的MyControllerAdvice，將MyException添加進(jìn)去：

  @ResponseBody
  @ExceptionHandler(value = MyException.class)
  public Map<String,Object> myExceptionHandler(MyException mex){
    Map<String,Object> map = new HashMap<String,Object>();
    map.put("code",mex.getErrorCode());
    map.put("msg",mex.getErrorMsg());
    //其他業(yè)務(wù)代碼...
    return map;
  }

測(cè)試：

  @GetMapping("/test1")
  public String test1(){
    String name = null;
    if(name == null){
      throw new MyException("101","用戶(hù)名為空");
    }
    return "Hello World";
  }

輸出：