java统一处理业务异常的核心是分离系统与业务异常，通过自定义异常类体系、全局异常处理器和枚举化错误码，实现业务逻辑清晰、反馈准确、运维高效。
Java中统一处理业务异常的核心是分离系统异常与业务异常，通过自定义异常类、全局异常处理器和规范化的错误码体系，让业务逻辑更清晰、错误反馈更准确、运维排查更高效。
设计分层的业务异常类体系
避免直接抛出 RuntimeException 或泛化异常（如 Exception），应建立明确的业务异常继承结构：
- 定义顶层业务异常基类（如
BusinessException），继承RuntimeException，默认非检查型，不强制上层 try-catch，符合业务异常“可预期、可恢复、需提示”的特性 - 按模块或场景派生子类（如
OrderNotFoundException、InsufficientBalanceException），便于类型判断和精准处理 - 每个异常实例携带
errorCode（字符串或枚举）、message（支持 i18n 占位符）和可选的业务上下文数据（如订单号、用户ID）
统一返回结构 + 全局异常拦截
在 Web 层（如 Spring Boot）使用 @ControllerAdvice + @ExceptionHandler 拦截所有业务异常，输出标准化响应体：
- 响应体包含固定字段：code（业务错误码，如
"ORDER_NOT_FOUND"）、msg（本地化提示语）、data（空或 null）、timestamp 等 - 对
BusinessException及其子类统一处理，记录 error 日志（含 errorCode 和关键参数），但不打印堆栈（业务异常无需完整 trace） - 对
Exception或Throwable做兜底处理，记录 warn/error 日志并返回通用服务异常码（如"SYSTEM_ERROR"），保护敏感信息
用枚举集中管理错误码与提示模板
避免错误码和提示语散落在各处，定义统一的 ErrorCode 枚举：
立即学习“Java免费学习笔记（深入）”；
- 每个枚举项包含 code（唯一标识）、 defaultMessage（默认中文）、i18nKey（用于多语言资源绑定）
- 构造
BusinessException时传入枚举实例，自动获取 code 和基础 message；运行时根据 Locale 动态解析国际化文案 - 配合配置中心或数据库，支持部分错误提示热更新（如运营临时调整拒绝话术）
在 Service 层主动抛出、不吞异常
业务校验失败时，直接抛出具体业务异常，而非返回错误码或布尔值：
- 例如库存不足时抛
new InsufficientStockException("SKUID-1001", 2)，而非return Result.fail("库存不足") - 避免在 service 中 catch 业务异常再转成其他形式——这会破坏异常传播链，导致全局处理器失效
- 第三方调用失败需区分：若属外部系统问题（如支付超时），包装为
ThirdPartyCallException；若属本系统可预判的业务规则（如优惠券已过期），仍用业务异常
不复杂但容易忽略的是异常语义的准确性——同一个“找不到”，用户不存在、订单不存在、商品不存在，应对应不同异常类型和错误码，前端才能做差异化交互。保持异常即契约，代码就自带文档性。
