异常链（Exception Chaining）

1. 引言

在本讲中，我们将讲解一种重要的异常处理技术——异常链（exception chaining）。即使你把一个异常“包装”成另一个异常，这项技术也能保留错误的根本原因信息。

在实际应用中，错误常常发生在调用栈的深处——例如在操作数据库、文件系统或网络时。假设你有一个访问数据库的方法，它可能抛出 SQLException。但在业务逻辑层你不希望用技术细节“污染”代码，更倾向于抛出你自己的异常，例如 UserManagementException。

如果只是直接抛出一个新的异常，会发生什么？

try {
    // 与数据库有关的操作
} catch (SQLException e) {
    throw new UserManagementException("处理用户时发生错误");
}

问题：
在这种情况下，有关数据库中到底发生了什么（以及调用栈！）的信息会丢失。日志中你只能看到 UserManagementException，而其原因是什么——不得而知。

2. 解决方案：包装原始异常（chaining）

Java 允许把一个异常“包装”到另一个异常中，将原始异常作为原因（cause）传递给新异常的构造函数。这就称为异常链。

如何实现？

大多数标准异常和自定义异常都有一个构造函数，接受第二个参数——Throwable cause：

public UserManagementException(String message, Throwable cause) {
    super(message, cause);
}

用法：

try {
    // 与数据库有关的操作
} catch (SQLException e) {
    throw new UserManagementException("处理用户时发生错误", e);
}

现在，如果你查看调用栈（printStackTrace()），你会同时看到你的异常以及一直追溯到根本原因的整个链条！

3. 如何获取异常的原因

任何类型为 Throwable 的对象都有方法 getCause()，它会返回原始异常（如果没有则为 null）。

示例：

try {
    // ...
} catch (UserManagementException e) {
    Throwable cause = e.getCause();
    if (cause != null) {
        System.out.println("根本原因: " + cause);
    }
    e.printStackTrace();
}

为什么需要这样做？

• 用于调试：你不仅能看到顶层“出了什么问题”，还可以看到错误在调用栈深处的具体发生位置。
• 用于日志记录：可以将整条错误链写入日志。
• 用于在应用的各层之间传递信息：业务层可以把技术性异常“包装”成自己的异常而不丢失细节.

4. 示例：实际应用中的异常链

假设你有一个从数据库加载用户的方法：

public User loadUser(String username) throws UserManagementException {
    try {
        // 可能抛出 SQLException 的代码
        // ...
    } catch (SQLException e) {
        throw new UserManagementException("无法加载用户: " + username, e);
    }
}

其中 UserManagementException 是你自定义的异常：

public class UserManagementException extends Exception {
    public UserManagementException(String message, Throwable cause) {
        super(message, cause);
    }
}

发生错误时会怎样？

• 在日志中可以看到你的异常以及原始的 SQLException 及其所有细节。
• 如有需要，可以通过 getCause() 获取根本原因。

5. 在异常链中调用栈是什么样的

输出示例：

UserManagementException: 无法加载用户: john
    at UserService.loadUser(UserService.java:15)
    ...
Caused by: java.sql.SQLException: Connection refused
    at ...

这里一目了然：完整的调用链、业务错误发生的位置，以及作为原因的技术性异常。

6. 实践：实现异常链

步骤 1：创建自定义异常：

public class UserManagementException extends Exception {
    public UserManagementException(String message) {
        super(message);
    }
    public UserManagementException(String message, Throwable cause) {
        super(message, cause);
    }
}

步骤 2：使用异常链：

try {
    // 危险操作
} catch (SQLException e) {
    throw new UserManagementException("数据库操作出错", e);
}

步骤 3：在顶层进行处理：
在程序的最高层捕获我们的自定义异常，并输出错误信息以及整条原因链。

public class Main {
    public static void main(String[] args) {
        try {
            runUserManagement();
        } catch (UserManagementException e) {
            System.err.println("发生错误: " + e.getMessage());
            // 输出原因链
            Throwable cause = e.getCause();
            while (cause != null) {
                System.err.println("原因: " + cause.getMessage());
                cause = cause.getCause();
            }
        }
    }

    private static void runUserManagement() throws UserManagementException {
        try {
            // 模拟数据库错误
            throw new SQLException("没有数据库连接");
        } catch (SQLException e) {
            throw new UserManagementException("数据库操作出错", e);
        }
    }
}

7. 使用异常链时的常见错误

错误 №1：抛出新异常但没有提供 cause。

catch (SQLException e) {
    throw new UserManagementException("错误", /* 没有 cause! */);
}

不佳：会丢失根本原因信息。

错误 №2：未在自定义异常中实现带 cause 的构造函数。
如果你的异常类没有带 Throwable cause 的构造函数，你将无法传递原因——只能手动添加它。

错误 №3：捕获后吞掉异常，不再向上抛出。

catch (SQLException e) {
    // 只记录日志然后沉默
}

不佳：错误被“吞掉”，程序会继续以不正确的状态运行。

try {
    userService.loadUser("john");
} catch (UserManagementException e) {
    System.err.println("错误: " + e.getMessage());
    if (e.getCause() != null) {
        System.err.println("根本原因: " + e.getCause());
    }
    e.printStackTrace();
}