17370845950

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 枚举：

• 每个枚举项包含 code（唯一标识）、 defaultMessage（默认中文）、i18nKey（用于多语言资源绑定）
• 构造 BusinessException 时传入枚举实例，自动获取 code 和基础 message；运行时根据 Locale 动态解析国际化文案
• 配合配置中心或数据库，支持部分错误提示热更新（如运营临时调整拒绝话术）

在 Service 层主动抛出、不吞异常

业务校验失败时，直接抛出具体业务异常，而非返回错误码或布尔值：

• 例如库存不足时抛 new InsufficientStockException("SKUID-1001", 2)，而非 return Result.fail("库存不足")
• 避免在 service 中 catch 业务异常再转成其他形式——这会破坏异常传播链，导致全局处理器失效
• 第三方调用失败需区分：若属外部系统问题（如支付超时），包装为 ThirdPartyCallException；若属本系统可预判的业务规则（如优惠券已过期），仍用业务异常

不复杂但容易忽略的是异常语义的准确性——同一个“找不到”，用户不存在、订单不存在、商品不存在，应对应不同异常类型和错误码，前端才能做差异化交互。保持异常即契约，代码就自带文档性。