在Java中如何保留原始异常信息_Java异常包装最佳实践解析_技术教程

throw new RuntimeException(e) 会丢失原始异常信息，因未显式设置cause且日志未调用含Throwable参数的error方法，导致堆栈和异常链无法完整展示。

为什么 `throw new RuntimeException(e)` 会丢失原始异常信息

直接用 RuntimeException 包装异常时，如果只传入 Throwable 实例（如 new RuntimeException(e)），JVM 会把该异常当作「原因（cause）」，但默认构造器不会自动设置栈轨迹（stack trace）归属——e.getStackTrace() 仍保留原异常的堆栈，而新异常的 printStackTrace() 默认只打印自身（空栈），导致调试时看不到原始抛出点。

真正丢失信息的不是「原因」本身，而是开发者没触发「异常链」的完整展示逻辑。Java 的 T

hrowable 类要求显式调用 initCause() 或使用带 cause 参数的构造器，并确保上层日志或捕获逻辑调用 printStackTrace() 或 getCause() 层层展开。

错误写法：

throw new RuntimeException(e); // e 是原始异常，但未显式设 cause（虽有隐式支持，但部分 JDK 版本/工具链不保证行为一致）

正确写法：

throw new RuntimeException("业务操作失败", e); // 显式传 cause，且带描述性消息

更安全写法（兼容老 JDK）：

RuntimeException wrapper = new RuntimeException("业务操作失败");
wrapper.initCause(e);
throw wrapper;

使用 `CauseConstructor` 时必须注意的三个参数顺序

所有标准异常类（如 IllegalArgumentException、IOException）都提供形如 Exception(String message, Throwable cause) 的双参构造器。这个顺序不能颠倒：消息必须在前，原因必须在后。一旦写成 new IllegalArgumentException(e, "msg")，编译器会匹配到 (Object) 单参构造器，把整个 e 当作「消息字符串」转成 e.toString()，原始异常对象被丢弃，只剩一串文本。

✅ 正确：new IllegalStateException("DB 查询超时", sqlException)
❌ 错误：new IllegalStateException(sqlException, "DB 查询超时") → 实际调用的是 IllegalStateException(Object)，sqlException 被 toString() 后塞进 message 字段，cause 为 null
⚠️ 注意：Exception(String) 和 Exception(Throwable) 都是合法单参构造器，但后者不设 cause，仅把 Throwable 当 message 输出（等价于 e.toString()）

日志框架中不调用 `logger.error(msg, e)` 就等于白包

即使你用对了构造器，把原始异常作为 cause 传进去了，如果日志输出时只写 logger.error("出错了：" + e.getMessage())，那堆栈和 cause 链全被丢弃。SLF4J / Log4j 等主流框架依赖第二个 Throwable 参数触发完整异常渲染。

✅ 正确：

logger.error("订单创建失败", wrappedException); // 自动展开 cause 链

❌ 错误：

logger.error("订单创建失败: " + wrappedException.getMessage()); // 只打一行，无堆栈，无 cause

⚠️ 补充：Spring Boot 默认配置下，error 级别日志会输出完整堆栈；若自定义了 PatternLayout，需确认格式中包含 %ex 或 %xEx 才能打印 cause 链

自定义异常类必须显式委托 `cause` 构造器

如果你写了 class BizException extends RuntimeException，默认继承的构造器不处理 cause。哪怕父类有 RuntimeException(String, Throwable)，子类也得自己声明并调用 super(message, cause)，否则所有包装都会断链。

✅ 必须写：

public class BizException extends RuntimeException {
    public BizException(String message, Throwable cause) {
        super(message, cause); // 关键：显式转发 cause
    }
}

❌ 不写就断链：new BizException("库存不足", inventoryException) 中，inventoryException 不会被设为 cause，而是被忽略（除非你在构造器里手动调 initCause()）
? 提示：用 Lombok 的 @AllArgsConstructor 无法自动处理 cause 委托，必须手写或改用 @SuperBuilder + 显式构造逻辑