优雅的异常处理需分层拦截、标准化封装与可配置降级，区分BusinessException、SystemException、ValidationException三类，统一ResponseResult响应结构，并通过@ControllerAdvice全局处理，增强上下文与可观测性。
Java中异常处理不该是“try-catch-e.printStackTrace()”的简单堆砌，而应统一响应结构、区分业务异常与系统异常、保留关键上下文，并支持灵活扩展。一个优雅的异常处理模板类，核心在于分层拦截 + 标准化封装 + 可配置降级，而非把所有逻辑塞进一个catch块。
定义清晰的异常分类体系
避免泛用Exception或RuntimeException，按语义划分三类基础异常：
- BusinessException：由业务规则触发（如“余额不足”“订单已取消”），应返回用户友好的提示码和消息，不打印堆栈
- SystemException：运行时不可控错误（如数据库连接超时、Redis宕机），需记录完整堆栈，返回通用错误码（如“SYSTEM_ERROR”）
- ValidationException：参数校验失败（常由@Valid触发），提取字段级错误信息，组装为结构化错误列表
统一响应包装器（ResponseResult）
所有接口返回同一泛型结构，包含状态码、消息、数据及可选的错误详情：
public class ResponseResult<T> {
private int code;
private String message;
private T data;
private Map<String, Object> details; // 仅错误时填充，如校验字段名+原因
// 构造方法略
}
成功时code=200，data有值；异常时code对应异常类型，message为前端可读文案，details用于调试或精细化提示（如{"email": "邮箱格式不正确"}）。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
全局异常处理器（@ControllerAdvice）
集中拦截，按异常类型匹配处理策略，避免每个Controller重复写try-catch：
- 捕获BusinessException → 返回400状态码 + 自定义业务码（如“BALANCE_INSUFFICIENT”）
- 捕获ValidationException → 遍历BindingResult，提取fieldErrors生成details映射
- 捕获Exception（兜底）→ 记录error日志（含traceId）、返回500 + “系统繁忙，请稍后重试”
- 对特定异常（如HttpClientErrorException）可额外适配HTTP状态码
异常构造与上下文增强
业务代码抛异常时，应携带必要上下文，而非裸字符串：
- 用构造函数注入traceId、请求ID、操作人ID等，便于问题追踪
- BusinessException支持链式构建：
throw BusinessException.of("ORDER_NOT_FOUND").withParam("orderId", id); - 日志记录时，统一提取异常中的上下文字段，避免日志里只有“订单不存在”而无id值
不复杂但容易忽略：异常不是错误的终点，而是可观测性的起点。
