spring boot项目09：全局异常处理-基础使用

JAVA 8

Spring Boot 2.5.3

---

访问Spring Web请求时，可能会出现一些异常（JDK或其它包定义或项目自定义的异常），此时，默认情况下，返回给调用方的是默认信息，比如：

为了统一响应信息格式等需求，因此，需要对这些异常做统一处理。

相关注解：

@ControllerAdvice + @ResponseBody 或 @RestControllerAdvice

@ExceptionHandler

注解源码

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface ControllerAdvice {

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@ControllerAdvice // 看这里
@ResponseBody
public @interface RestControllerAdvice {

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ExceptionHandler {

示例代码：

拦截 org.lib.mysqlhello 包（项目根包）下所有 Exception异常——范围很大。

/**
 * 统一异常处理
 * 使用切面时，如果处理了异常 并且 返回了值，则不会执行到这里
 * @author ben
 * @date 2021-08-22 13:02:34 CST
 */
@ControllerAdvice(value = {"org.lib.mysqlhello"})
@ResponseBody
// 同上面两个注解等效
//@RestControllerAdvice(value = {"org.lib.mysqlhello"})
@Slf4j
public class AppExceptionHandler {

	/**
	 * 注解 ResponseBody 是关键
	 * @author ben
	 * @date 2021-08-22 14:06:17 CST
	 * @param e
	 * @return
	 */
	@ExceptionHandler(value = {Exception.class})
	ResultVO<Object> handleException(Exception e) {
		log.error("发生异常: e={}, e.message={}", e.getClass(), e.getMessage());
		return ResultVO.getFailed(500, "发生异常-AppExceptionHandler", null);
	}
	
}

注：上面的 ResultVO类是定义的项目统一返回类；返回的第三个参数为 null。

上面只有一个 @ExceptionHandler ，实际使用时可以定义多个，用来拦截不同的 Exception。

存在多个时，还需要考虑到它们的顺序。

测试结果：