通过@ControllerAdvice和@ExceptionHandler实现全局异常处理，1. 使用@ControllerAdvice注解定义全局异常处理器类；2. 用@ExceptionHandler捕获特定异常如NullPointerException、ResourceNotFoundException等并返回定制化响应；3. 定义统一的ErrorResponse结构确保前后端错误信息格式一致；4. 创建BusinessException等自定义异常处理业务场景，提升代码可读性与维护性。
在Java开发中，特别是使用Spring或Spring Boot框架时，统一异常处理机制可以集中管理程序中的各种异常，避免重复的try-catch代码，提升代码可维护性和用户体验。实现这一机制的核心是利用Spring提供的@ControllerAdvice和@ExceptionHandler注解。
1. 使用@ControllerAdvice全局捕获异常
@ControllerAdvice是一个组合注解，底层包含@Component，能够将类扫描为Spring容器中的Bean，并使其成为全局的异常处理器。
创建一个异常处理类：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
public ResponseEntity handleGenericException(Exception e) {
ErrorResponse error = new ErrorResponse("服务器内部错误", e.getMessage());
return ResponseEntity.status(500).body(error);
}
}
这个类会拦截所有控制器中抛出的异常，无需在每个Controller中单独处理。
立即学习“Java免费学习笔记（深入）”；
2. 针对特定异常定制处理逻辑
可以根据不同类型的异常返回不同的响应信息和状态码，提高接口的友好性。
例如处理空指针、资源未找到、参数校验失败等常见异常：
@ExceptionHandler(NullPointerException.class) public ResponseEntityhandleNPE(NullPointerException e) { ErrorResponse error = new ErrorResponse("数据为空", "请求的数据不存在"); return ResponseEntity.status(400).body(error); } @ExceptionHandler(ResourceNotFoundException.class) public ResponseEntity handleResourceNotFound(ResourceNotFoundException e) { ErrorResponse error = new ErrorResponse("资源未找到", e.getMessage()); return ResponseEntity.status(404).body(error); } @ExceptionHandler(MethodArgumentNotValidException.class) public ResponseEntity handleValidationException(MethodArgumentNotValidException e) { String message = e.getBindingResult().getFieldErrors().stream() .map(FieldError::getDefaultMessage) .collect(Collectors.joining(", ")); ErrorResponse error = new ErrorResponse("参数校验失败", message); return ResponseEntity.status(400).body(error); }
3. 定义统一的错误响应结构
为了前后端交互清晰，建议定义一个通用的错误响应体格式：
系统简介：冰兔BToo网店系统采用高端技术架构，具备超强负载能力，极速数据处理能力、高效灵活、安全稳定；模板设计制作简单、灵活、多元；系统功能十分全面，商品、会员、订单管理功能异常丰富。秒杀、团购、优惠、现金、卡券、打折等促销模式十分全面；更为人性化的商品订单管理，融合了多种控制和独特地管理机制；两大模块无限级别的会员管理系统结合积分机制、实现有效的推广获得更多的盈利！本次更新说明：1. 增加了新
public class ErrorResponse {
private String errorCode;
private String message;
public ErrorResponse(String errorCode, String message) {
this.errorCode = errorCode;
this.message = message;
}
// getter 和 setter 省略
}
这样前端接收到的错误信息结构一致，便于统一处理提示。
4. 自定义业务异常增强可读性
除了系统异常，业务逻辑中也可能需要抛出自定义异常，比如余额不足、权限不足等。
定义一个自定义异常类：
public class BusinessException extends RuntimeException {
public BusinessException(String message) {
super(message);
}
}
在业务代码中直接抛出：
if (balance < amount) {
throw new BusinessException("余额不足");
}
然后在GlobalExceptionHandler中添加对应处理方法：
@ExceptionHandler(BusinessException.class) public ResponseEntityhandleBusinessException(BusinessException e) { ErrorResponse error = new ErrorResponse("BUSINESS_ERROR", e.getMessage()); return ResponseEntity.status(400).body(error); }
基本上就这些。通过以上方式，Java项目就能实现一套清晰、可维护的统一异常处理机制，减少冗余代码，提升系统健壮性。关键是把异常拦截和响应封装好，让业务代码更专注于核心逻辑。
