Java业务异常怎么设计_Java业务异常体系构建方案_网络技术

应构建分层业务异常体系：业务异常（如余额不足）用BizException子类抛出，不打堆栈；系统异常（如NPE）需记录完整堆栈并修复；技术异常（如DB超时）统一兜底降级。

Java业务异常不该直接 throw new RuntimeException("xxx")，更不能让底层技术异常（如 SQLException、RedisConnectionException）穿透到上层业务逻辑。一套清晰、分层、可捕获、易监控的业务异常体系，是保障系统健壮性与可维护性的基础。

这是设计起点。混淆会导致处理逻辑混乱、日志泛滥、告警失真。

业务异常：代表业务规则被违反，属预期内失败，比如“余额不足”、“订单已取消”、“手机号已注册”。这类异常不打印堆栈，应被业务层主动捕获并转化为用户友好的提示。
系统异常：指应用自身逻辑缺陷导致的非预期错误，如空指针、数组越界、NPE。这类异常必须记录完整堆栈，属于 bug，需修复。
技术异常：来自外部依赖的故障，如数据库超时、HTTP 调用失败、MQ 发送异常。这类异常要统一兜底降级/重试，并标记为“外部依赖失败”，避免和业务逻辑混为一谈。

避免满屏 new RuntimeException。建议定义一个抽象基类，再按模块或场景派生具体异常。

基类 BizException 继承 RuntimeException，含 errorCode（String）、message、args（用于参数化提示），默认不打印堆栈（重写 fillInStackTrace() 返回 this）。
子类示例：OrderBizException（订单域）、UserBizException（用户域）、PayBizException（支付域）。每个子类对应一组预定义 error code，如 ORDER_NOT_FOUND("ORDER_001")、INSUFFICIENT_BALANCE("PAY_002")。
code 建议采用“模块_编号”格式，便于日志检索、监控聚合、前端国际化映射。

用 @ControllerAdvice + @ExceptionHandler 拦截所有未被捕获的异常，按类型差异化处理：

捕获 BizException：返回 HTTP 200 + { "code": "PAY_002", "msg": "余额不足", "data": null }；记录轻量日志（如 traceId + code + userId + orderId）。
捕获 RuntimeException（非 BizException）：返回 HTTP 500 + 通用错误码；记录 ERROR 级别日志 + 完整堆栈；触发告警（如企业微信/钉钉机器人）。
捕获 IOException / TimeoutException 等技术异常：返回 HTTP 503 或自定义“服务暂不可用”码；记录 WARN 日志 + 依赖名 + 耗时；可集成熔断器（如 Sentinel）自动降级。

杜绝在 service 层写 try-catch-log-rethrow，也避免把技术异常包装成业务异常（比如把 DB 连接失败说成“用户不存在”）。

校验失败时直接 throw new OrderBizException(ORDER_STOCK_SHORTAGE, "库存不足，剩余{0}件", stock)；前端根据 code 渲染对应提示。
调用下游接口前先做前置校验（如参数合法性、状态一致性），校验失败走 BizException；调用失败则原样抛出或转为技术异常封装，交由全局处理器兜底。
事务方法内慎用 try-catch 吞掉 BizException，否则 @Transactional 可能不回滚（需确保异常未被吞且是 RuntimeException 子类）。

基本上就这些。核心是让每种异常各司其职：业务异常讲人话、系统异常追根源、技术异常管依赖。体系建好了，排查省一半力，上线少一半火。