在Spring Boot中,通过@ControllerAdvice和@ExceptionHandler实现全局异常处理,统一返回格式化错误信息,提升前后端交互规范性。

在Spring框架中,JS通常指的是JavaScript,但这里提到的“JS”可能是笔误或误解。实际开发中,我们不会用JavaScript直接处理Spring(Java后端框架)中的异常。正确的理解应为:如何在Spring(尤其是Spring Boot)项目中实现全局异常处理。以下是完整的异常处理流程,基于Java语言和Spring提供的机制。
使用@ControllerAdvice进行全局异常处理
Spring提供了@ControllerAdvice注解,用于定义全局异常处理器。它能捕获所有Controller中抛出的异常,统一返回格式化的错误信息。
创建一个全局异常处理类:
@ControllerAdvicepublic class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
@ResponseBody
public Map
Map
result.put("success", false);
result.put("message", e.getMessage());
result.put("timestamp", System.currentTimeMillis());
return result;
}
}
这样,任何Controller中未被捕获的异常都会被这个方法拦截,并返回JSON格式的响应。
针对特定异常定制处理逻辑
你可以为不同类型的异常编写不同的处理方法,提高错误响应的精确性。
- @ExceptionHandler(NullPointerException.class) 处理空指针异常
- @ExceptionHandler(IllegalArgumentException.class) 处理非法参数异常
- @ExceptionHandler(BindException.class) 处理表单验证失败
例如:
@ExceptionHandler(NullPointerException.class)public ResponseEntity
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("数据为空,请检查输入");
}
结合Validation实现参数校验异常处理
在实际项目中,常使用@Valid对请求参数进行校验。当校验失败时会抛出MethodArgumentNotValidException。
在全局异常处理器中添加对该异常的处理:
@ExceptionHandler(MethodArgumentNotValidException.class)public Map
Map
List
.stream().map(FieldError::getDefaultMessage).collect(Collectors.toList());
result.put("success", false);
result.put("errors", errors);
return result;
}
这样前端提交的数据校验失败时,能收到清晰的错误提示列表。
自定义业务异常并抛出
为了更好地管理业务逻辑中的错误,建议定义自己的异常类:
public class BusinessException extends RuntimeException {public BusinessException(String message) {
super(message);
}
}
在Service中使用:
if (user == null) {throw new BusinessException("用户不存在");
}
然后在@ControllerAdvice中增加对应处理方法,返回友好的提示信息。
基本上就这些。Spring的异常处理机制非常灵活,通过@ControllerAdvice和@ExceptionHandler组合,可以实现统一、清晰、可维护的错误响应体系。重点是规范异常类型,统一输出结构,便于前端解析处理。










