高内聚错误处理模块需通过统一异常基类、按域建模子类、精准抛出点和全局处理器四维度实现闭环；核心是分层设计+约定规范+统一入口，确保各环节职责清晰不交叉。
高内聚的错误处理模块，核心是让异常定义、抛出、捕获、转换和响应形成闭环，且各环节职责清晰、不交叉。在 Java 中，这不是靠单个异常类实现的，而是通过分层设计 + 约定规范 + 统一入口来达成。下面从四个关键维度说明怎么做。
统一异常基类：收敛所有业务异常源头
定义一个顶层业务异常基类（如 BaseBusinessException），所有自定义异常都继承它。这个基类不直接抛出，只提供共性能力：
- 封装标准字段：错误码（errorCode）、国际化消息键（messageKey）、业务上下文（如 userId、orderId）
- 支持链式构造：同时传入原始异常（cause）和业务参数，保留堆栈又不失语义
- 实现 Serializable 并声明 serialVersionUID，适配分布式调用或日志序列化场景
按域建模异常子类：语义隔离，避免泛化
不要写一个“万能”异常类。而是按业务域划分子类，每个类对应明确的失败场景：
- UserDomainException：覆盖用户注册/登录/权限校验失败
- OrderDomainException：覆盖库存不足、订单状态非法、支付超时等
- PaymentDomainException：专用于支付网关返回的特定错误（如余额冻结、渠道拒付）
命名以 Exception 结尾，动词+名词结构（如 InsufficientStockException），拒绝使用 MyException 或 ErrorException 这类模糊名称。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
异常抛出点：只在真正“失控”的业务边界抛出
不是每处 if 都要 throw。高内聚要求异常只出现在以下位置：
- 服务接口层（如 Controller 或 Feign Client 回调）——对外暴露的失败契约
- 领域服务核心校验点（如 “扣减库存前检查可用量”）——违反强业务规则时
- 外部依赖返回不可恢复结果时（如第三方 API 明确返回 “INVALID_TOKEN”）
避免在工具类、DTO 转换、日志打印等辅助逻辑中抛业务异常；这类问题应通过返回 Optional、Result 封装或静默处理。
全局异常处理器：一次拦截，多端响应
用 @ControllerAdvice + @ExceptionHandler 统一收口，做到：
- 对不同子类异常走不同处理路径（如 UserDomainException 返回 400，SystemException 记录 ERROR 日志并返回 500）
- 自动将错误码映射为前端可读文案（通过 ResourceBundle 或 i18n 服务）
- 脱敏敏感字段（如不把数据库异常堆栈、SQL 片段直接返回给前端）
- 对重复请求、幂等失败等场景，补充 traceId 和时间戳便于排查
这个处理器就是整个错误模块的“神经中枢”，所有异常流经此处完成格式化、分级、响应，不再散落在各 service 方法里手动 try-catch。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
