企业级项目异常需分三层：基础异常类（继承runtimeexception，含错误码、消息、上下文）、业务异常类（按模块划分，静态工厂封装）、系统/第三方异常类（支持差异化重试降级）；错误码采用“模块-类型-序号”三级枚举管理；强制异常链传递与上下文注入（threadlocal/mdc）；全局异常处理器统一返回结构化响应并集成监控。
明确异常分层结构
企业级项目里，异常不能零散定义，必须按领域和职责分层。通常划为三层：基础异常类、业务异常类、系统/第三方异常类。基础类继承 RuntimeException，统一携带错误码、消息、上下文参数（如用户ID、订单号），不强制捕获；业务异常（如 UserException、OrderException）继承基础类，按模块划分，每个类内部用静态工厂方法封装常用错误场景；系统异常（如数据库连接失败、Redis超时）和外部服务异常（如支付网关调用失败）也各自独立成类，便于后续做差异化重试或降级。
统一错误码与消息管理
错误码不是随便编的数字，要采用“模块-类型-序号”三级编码，例如 USER-404-001 表示用户模块的“未找到”类第1种情况。所有错误码集中定义在枚举类中，每个枚举项包含码值、默认提示语、HTTP状态码（Web场景）、日志级别。异常构造时只传枚举实例，避免字符串硬编码。这样前端可直接映射提示文案，运维可通过码值快速归类告警，日志平台也能按码聚合分析故障趋势。
强制异常链传递与上下文注入
任何 catch 后重新抛出异常，必须把原始异常作为 cause 传入构造器——这是保留根因的底线要求。同时，在全局拦截器或 AOP 切面中自动注入关键上下文，比如当前登录用户、请求 traceId、接口路径。这些信息不写死在异常类字段里，而是通过 ThreadLocal 或 MDC 注入日志，既避免污染异常对象，又确保排查时能还原完整现场。禁止出现 “操作失败” 这类无信息异常，也不允许空 catch 块。
集成全局异常处理器与标准化响应
Spring 项目用 @ControllerAdvice 统一捕获自定义异常，按异常类型返回结构化 JSON，含 code、message、timestamp 和可选的 details 字段。对业务异常返回 200 状态码 + 业务错误码（避免前端误判为成功），系统异常才返回 5xx HTTP 状态。同时配置统一日志记录器，自动打印堆栈、traceId 和上下文参数，并对接 ELK 或 Prometheus 实现错误率监控。所有异常最终都走同一出口，不分散处理。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
