java自定义异常支持异常链的关键是必须提供并正确实现带string和throwable参数的构造方法，且内部调用super(message, cause)；同时应提供无参和仅含message的构造器以覆盖全场景，禁用initcause()替代。
Java 自定义异常要支持链式调用（即异常链），关键不是“调用”本身链式，而是让异常对象能携带并传递原始异常作为 cause。这需要在构造器中显式接收并委托给父类，而不是靠方法链式调用（如 builder 模式）。下面直接说清楚怎么做、为什么这么写、以及容易踩的坑。
必须提供带 Throwable cause 的构造器
这是支持异常链的硬性前提。JVM 和日志框架（如 Log4j、SLF4J）都依赖这个构造器来建立和展开 cause 链。
- 继承
Exception或RuntimeException后，务必声明一个形如public XxxException(String message, Throwable cause)的构造器 - 构造器内部必须调用
super(message, cause)，把 cause 正确传给父类 - 不写这个构造器，或写了但没调
super(..., cause)，e.getCause()就永远是null
推荐同时保留无参和单参构造器
方便不同场景使用，也符合 Java 异常设计惯例：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
public InsufficientBalanceException()：供框架自动实例化（如 Spring 的 @ResponseStatus 异常解析） -
public InsufficientBalanceException(String message)：日常业务抛出，不涉及封装底层异常时用 -
public InsufficientBalanceException(String message, Throwable cause)：捕获了 IOException/SQLException 等后包装成业务异常时用
不要用 initCause() 代替构造器传参
initCause() 是补救手段，不是标准路径：
- 它只能调用一次，且要求当前异常的
cause还是null - 如果异常对象已由框架创建（比如被反序列化或代理生成），再调
initCause()很可能失败 - 所有现代 JDK 和主流框架异常类（包括 Spring 的
NestedRuntimeException）都优先走构造器路径
验证是否真正支持链式
光写对构造器还不够，得确保使用时也正确传参：
- ✅ 正确：
throw new InsufficientBalanceException("余额不足", sqlEx); - ❌ 错误：
throw new InsufficientBalanceException("余额不足");—— 原始异常丢失 - ❌ 错误：
throw new InsufficientBalanceException("余额不足").initCause(sqlEx);—— 冗余且易出错 - 日志中检查：用
logger.error("转账失败", e)，看输出是否包含Caused by:及其堆栈
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
