异常链需显式构建，最推荐用带cause的构造函数（如new BusinessException("消息", e)），自定义异常应继承并调用super(message, cause)；老异常类才需initCause()，且须在throw前调用；Java不会自动建立异常链。

异常链就是把一个异常“包进”另一个异常里，让调用方既能看清当前出错的业务语义（比如“订单创建失败”），又能顺着 getCause() 一层层查到最原始的根因（比如“数据库连接超时”）。

怎么用构造函数建立异常链（最推荐）

Java自1.4起，所有 Throwable 子类（包括 Exception 和 Error）都支持带 cause 的构造函数。这是最安全、最直观的方式。

• 直接传入原始异常：new BusinessException("库存扣减失败", e)
• 底层会自动调用 initCause(e)，并保留原始堆栈
• 不需要手动调用 fillInStackTrace()，也不会出现 NullPointerException（不像 initCause() 手动调用容易踩坑）
• 自定义异常类只要继承 Exception 或 RuntimeException，并在构造函数里调用 super(message, cause) 就能天然支持

public class InventoryException extends RuntimeException {
    public InventoryException(String message, Throwable cause) {
        super(message, cause); // ✅ 自动建立链
    }
}

什么时候必须用 initCause()？

只有当你面对的是**老版本自定义异常类**，且它没提供带 cause 的构造函数时，才需要手动补救。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

• 必须在 throw 前调用，且只能调用一次
• 绝对不能在 fillInStackTrace() 之后调用（否则抛 IllegalStateException）
• 现代代码中基本不用——新写的异常类请直接支持双参构造函数
• 常见错误：捕获后新建异常再调 initCause()，却忘了 throw 它，反而继续抛了旧异常

别信“自动异常链”，那是误解

有资料说“直接 throw new MyException("xxx") 也会保留原始异常”，这是错的。Java **不会自动建立链**——除非你显式传入 cause 或调用 initCause()。

• 如果你只写 throw new BusinessException("失败")，原始异常 e 就彻底丢失了
• 日志里只剩空洞描述，排查时得靠猜：是网络问题？序列化失败？还是 NPE？
• 线上环境一旦丢掉 cause，等于主动放弃 80% 的根因线索

真正难的不是写对语法，而是每次 catch 到异常时，下意识问一句：“这个 e 能不能暴露给上层？”——漏掉一次，就可能让一个本可秒定位的问题拖成通宵排查。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南