如何在 Java 中通过自定义异常类封装特定领域的错误码与业务上下文信息-java教程-PHP中文网

java自定义异常应继承runtimeexception，用结构化错误码枚举（如order_not_found）替代字符串，提供三类构造函数并正确调用super，上下文信息存入context字段而非message。

在 java 中，自定义异常类封装错误码与业务上下文，核心是让异常本身成为结构化、可识别、可追溯的业务信号，而不是一串模糊字符串。关键不在于“抛出异常”，而在于“传递语义”。

必须继承 RuntimeException，而非 Exception

业务异常属于“预期失败”，不是程序崩溃。继承 RuntimeException 才能避免强制 throws 声明，不污染服务接口；Spring 的 @RestControllerAdvice 默认只捕获非受检异常；事务管理器（如 @Transactional）对 RuntimeException 默认回滚——但你要通过异常类型或字段控制是否真回滚（比如“余额不足”不该回滚已查出的余额值）。

只有极少数集成场景（如调用银行 SDK 遇到签名失败）才考虑受检异常，日常业务一律用 RuntimeException 子类。

错误码必须结构化，且与协议解耦

错误码不能是硬编码字符串，也不能混入 HTTP 状态码（如 400、500）。它应是纯业务语义的枚举或常量，例如：

ORDER_NOT_FOUND（1001）
INSUFFICIENT_BALANCE（1002）
COUPON_EXPIRED（1003）

这样做的好处：RPC 调用时可直接透传该码；前端根据 code 映射提示文案；国际化时只需替换 message，code 不变；监控系统可按 code 统计错误率。HTTP 状态码由 Controller 层统一映射（如 ORDER_NOT_FOUND → 404，INSUFFICIENT_BALANCE → 409）。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

构造函数要覆盖三类典型使用场景

只写一个构造函数会丢失关键能力。至少提供以下三种：

BizException(ErrorCode code, String message)：用于简单业务拒绝，如“订单不存在”
BizException(String message, Throwable cause)：用于包装底层异常（如 DAO 抛出的 SQLException），保留原始堆栈链
BizException(ErrorCode code, String message, Throwable cause)：最完整形态，既带语义又带根因，排查时一眼定位是规则拦截还是依赖故障

注意：每个构造函数都必须调用 super(message, cause) 或 super(message)，否则 getMessage() 返回 null 或空字符串，日志第一行就失效。

用 context 字段携带运行时上下文，别拼在 message 里

用户 ID、订单号、请求参数等现场信息，应存进异常类的 Map context 字段，而不是拼进 message 字符串。原因有三：

message 是给人看的，context 是给系统用的——日志框架、链路追踪、告警规则可直接提取 context 中的 orderNo 做聚合
避免敏感信息泄露：密码、token、原始 SQL 绝不能进 message，但可安全存入 context 并由日志脱敏策略统一处理
便于动态组装：重写 toString() 时可格式化输出 "[ORDER_NOT_FOUND][orderNo=ORD123456] 订单不存在"，但逻辑判断永远基于 getErrorCode() 和 getContext().get("orderNo")

示例用法：throw new BizException(ORDER_NOT_FOUND, "订单查询失败", e).withContext("orderNo", "ORD123456").withContext("userId", 1001);