使用@ControllerAdvice统一处理异常，通过自定义BusinessException区分业务与技术异常，结合@ExceptionHandler对不同异常返回对应状态码，并记录日志以提升排查效率。
在Java应用开发中，统一处理异常能提升代码的可维护性和用户体验。通过集中管理异常，可以避免重复的try-catch代码块，并确保所有异常都以一致的方式记录和响应。
使用@ControllerAdvice处理全局异常
Spring提供了@ControllerAdvice注解，用于定义全局异常处理器。它能捕获所有控制器中抛出的异常，实现统一响应格式。
常见做法是创建一个异常处理类：
- 用@ControllerAdvice标注类，使其生效于所有Controller
- 使用@ExceptionHandler注解方法，指定处理的异常类型
- 返回统一格式的数据，如JSON错误信息
例如：
立即学习“Java免费学习笔记（深入）”；
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
public ResponseEntity<Map<String, Object>> handleException(Exception e) {
Map<String, Object> response = new HashMap<>();
response.put("error", e.getMessage());
response.put("timestamp", System.currentTimeMillis());
return ResponseEntity.status(500).body(response);
}
}
自定义业务异常增强可读性
系统内置异常难以表达业务含义。建议定义自己的异常类，比如BusinessException，便于区分技术异常和业务规则异常。
- 继承RuntimeException，避免强制捕获
- 添加错误码字段，方便前端识别处理
- 构造函数支持传入消息和参数
这样在业务逻辑中可以直接抛出有意义的异常，由全局处理器统一拦截并返回结构化信息。
结合日志记录提高排查效率
异常发生时，仅返回用户提示不够。应在全局处理器中加入日志输出，帮助开发定位问题。
推荐使用SLF4J或Logback，在handle方法中记录异常堆栈：
logger.error("Unexpected error: ", e);
注意敏感信息脱敏，避免将数据库细节或内部路径暴露给客户端。
对特定异常做差异化处理
不同异常应有不同响应策略。可以在同一个类中编写多个@ExceptionHandler方法。
- 处理NullPointerException时返回400
- 权限异常返回403
- 资源未找到返回404
也可以捕获自定义异常并提取错误码，返回对应的国际化消息。
基本上就这些。合理使用@ControllerAdvice配合自定义异常和日志，能让Java应用的异常处理更整洁高效。
