Spring Boot捕捉全局异常并统一返回值的问题及解决方案

在Spring Boot开发中，经常要捕捉全局异常，并根据不同的异常类型，统一返回不同的响应值，以达到统一的响应格式，提高开发效率。但是，Spring Boot捕获全局异常并统一返回值的问题却是一个比较头疼的问题。下面，就来介绍一种解决方案：

1. 定义异常处理类

我们需要定义一个异常处理类，用于捕捉全局异常。该类需要实现Spring Boot的ErrorController接口，并重写getErrorPath()方法，指定异常处理路径。

@Controller
public class GlobalExceptionHandler implements ErrorController {
    private static final String ERROR_PATH = "/error";

    @Override
    public String getErrorPath() {
        return ERROR_PATH;
    }

    @RequestMapping(value = ERROR_PATH)
    @ResponseBody
    public Object handleError(HttpServletRequest request) {
        // 捕获全局异常，并返回响应值
    }
}

2. 配置异常处理类

我们需要在Spring Boot的配置文件中，注入异常处理类，以达到捕捉全局异常的目的。

@Configuration
public class GlobalExceptionHandlerConfig {
    @Bean
    public GlobalExceptionHandler globalExceptionHandler() {
        return new GlobalExceptionHandler();
    }
}

3. 定义异常响应类

为了统一返回响应值，我们需要定义一个异常响应类，用于封装响应值。该类需要定义一个code属性，用于标识响应状态；以及一个data属性，用于封装响应数据。

public class ErrorResponse {
    private int code;
    private Object data;

    public ErrorResponse(int code, Object data) {
        this.code = code;
        this.data = data;
    }

    public int getCode() {
        return code;
    }

    public void setCode(int code) {
        this.code = code;
    }

    public Object getData() {
        return data;
    }

    public void setData(Object data) {
        this.data = data;
    }
}

4. 定义异常类

我们需要定义一系列异常类，用于捕捉不同类型的异常，并进行处理。每一个异常类都需要继承自Spring Boot的RuntimeException类，并定义一个唯一的异常码，以便在处理异常时，能够准确的区分不同的异常类型。

public class ParameterException extends RuntimeException {
    public static final int PARAMETER_EXCEPTION_CODE = 1001;

    public ParameterException() {
        super("参数错误");
    }

    public ParameterException(String message) {
        super(message);
    }
}

public class PermissionException extends RuntimeException {
    public static final int PERMISSION_EXCEPTION_CODE = 1002;

    public PermissionException() {
        super("权限不足");
    }

    public PermissionException(String message) {
        super(message);
    }
}

5. 处理异常

我们需要在异常处理类中，根据不同的异常类型，进行统一的处理，并返回相应的响应值。

@Controller
public class GlobalExceptionHandler implements ErrorController {
    private static final String ERROR_PATH = "/error";

    @Override
    public String getErrorPath() {
        return ERROR_PATH;
    }

    @RequestMapping(value = ERROR_PATH)
    @ResponseBody
    public Object handleError(HttpServletRequest request) {
        Object object = request.getAttribute(RequestDispatcher.ERROR_EXCEPTION);
        if (object instanceof ParameterException) {
            ParameterException exception = (ParameterException) object;
            return new ErrorResponse(ParameterException.PARAMETER_EXCEPTION_CODE, exception.getMessage());
        } else if (object instanceof PermissionException) {
            PermissionException exception = (PermissionException) object;
            return new ErrorResponse(PermissionException.PERMISSION_EXCEPTION_CODE, exception.getMessage());
        } else {
            return new ErrorResponse(500, "服务器内部错误");
        }
    }
}

以上就是。通过以上步骤，我们可以实现全局异常的捕获，并统一返回响应值，从而提高开发效率。