SpringBoot自定义异常，优雅解决业务逻辑中的错误

概要

你是不是在为业务逻辑中出现的异常弄的焦头烂额，常常在后台报错，前端却无法提示错误内容，导致用户体验极差？比如下单失败，前端只能提示下单失败，但是却不知道为什么失败，是库存不足，还是余额不足，亦或是商品已经失效？

之前想在 service 层直接返回封装好的 Reponse(code, data,msg) 对象，这样的话我就直接在service层提示出错原因了（msg：错误提示），但是这样代码就不够美观，因为Response原本是设计为后端统一返回的对象，太臃肿，最后决定用自定义异常来完成。

定义常见的错误枚举类

import lombok.AllArgsConstructor;
import lombok.Getter;

/**
 * @author: zp
 * @Date: 2019-10-10 14:47
 * @Description:
 */
@Getter
@AllArgsConstructor
public enum  ErrorType {
    /**
     * 错误类型
     */
    OBJECT_NOT_FOUND(0,"对象不存在"),

    INVALID_PARAMS(1,"参数不正确"),

    result_not_exist(2,"记录不存在")

    ;

    /**
     * 错误码
     */
    private int code;

    /**
     * 提示信息
     */
    private String msg;
}

自定义异常

提供了两个构造方法，一个用来提示常见的错误（枚举类中的），另一个提示不常用的（一次两次的那种），可拓展。

import com.example.demojpa.enums.ErrorType;
import lombok.Getter;

/**
 * @author: zp
 * @Date: 2019-10-10 14:42
 * @Description:
 */
@Getter
public class ServiceException extends RuntimeException{
    private Integer code;

    /**
     * 使用已有的错误类型
     * @param type 枚举类中的错误类型
     */
    public ServiceException(ErrorType type){
        super(type.getMsg());
        this.code = type.getCode();
    }

    /**
     * 自定义错误类型
     * @param code 自定义的错误码
     * @param msg 自定义的错误提示
     */
    public ServiceException(Integer code, String msg){
        super(msg);
        this.code = code;
    }
}

定义响应对象及工具类（这个不是必需的）

• 响应对象

    /**
     * @author: zp
     * @Date: 2019-10-10 15:22
     * @Description:
     */
    @Data
    public class Response {

            /**
             * 状态码
             */
            private Integer code;

            /**
             * 请求成功时返回的对象
             */
            private T data;

            /**
             * 提示信息
             */
            private String msg;

    }

• 工具类

    import com.example.demojpa.model.Response;

    /**
     * @author: zp
     * @Date: 2019-10-10 15:48
     * @Description:
     */
    public class ResponseUtils {
            /**
             * 调用成功
             */
            private static final String SUCCESS = "调用成功！";

            public static Response success(Object obj){
                    Response res = new Response();
                    res.setCode(200);
                    res.setData(obj);
                    res.setMsg(SUCCESS);
                    return res;
            }

            public static Response success(){
                    return success(null);
            }

            public static Response error(Integer code, String msg){
                    Response res = new Response();
                    res.setCode(code);
                    res.setMsg(msg);
                    return res;
            }

    }

异常处理类

import com.example.demojpa.exception.ServiceException;
import com.example.demojpa.model.Response;
import com.example.demojpa.utils.ResponseUtils;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * @author: zp
 * @Date: 2019-10-10 15:11
 * @Description:
 */

@ControllerAdvice 
public class ServiceExceptionHandler {

    /**
     * @ExceptionHandler相当于controller的@RequestMapping
     * 如果抛出的的是ServiceException，则调用该方法
     * @param se 业务异常
     * @return
     */
    @ExceptionHandler(ServiceException.class)
    @ResponseBody
    public Response handle(ServiceException se){
        return ResponseUtils.error(se.getCode(),se.getMessage());
    }
}

测试

为了简单一点，我直接在controller中抛异常，看看结果。

@GetMapping("/exception/{msg}")
    public String exception(@PathVariable String msg) throws InvalidParamExceptionAbstract, NoSuchObjectExceptionAbstract {
        if(StringUtils.isEmpty(msg)){
            throw new ServiceException(ErrorType.INVALID_PARAMS);
        }else if("null".equals(msg)) {
            throw new ServiceException(ErrorType.OBJECT_NOT_FOUND);
        }else{
            throw new ServiceException(250,"瞧你那傻样！");
        }
    }

关注我不会让你失望哟～