SQLException 通过 getNextException() 构成单向异常链，用于关联同一操作引发的多个并列异常；遍历时需用 while 循环判空，注意驱动兼容性与 SQLState/ErrorCode 的日志价值。
SQLException 支持链式异常（chained exceptions），当一次数据库操作触发多个异常（例如事务回滚时清理资源又出错、连接中断后尝试关闭连接失败等），这些异常会通过 getNextException() 串联成一个单向链表。遍历时需注意循环终止条件和空值安全。
理解 SQLException 的异常链结构
Java 中的 SQLException 继承自 Exception，但额外提供了 getNextException() 方法，用于获取由同一操作引发的“下一个”相关异常。这个链不是嵌套（cause）关系，而是并列关联关系，常见于：
- 执行批处理（
executeBatch()）时部分语句失败，驱动可能聚合多个错误 - 连接池在 close() 过程中，先抛出主异常（如 SQLTimeout），再因资源清理失败附加其他 SQLException
- XA 事务或分布式事务中多节点反馈的复合错误
标准遍历写法（推荐）
用 while 循环 + 判空方式逐个获取，避免 NullPointerException 和无限循环：
try {
// 执行数据库操作
stmt.executeUpdate("INSERT INTO ...");
} catch (SQLException e) {
SQLException current = e;
int index = 0;
do {
System.err.println("异常 [" + index + "]: " + current.getMessage());
System.err.println(" SQLState: " + current.getSQLState());
System.err.println(" ErrorCode: " + current.getErrorCode());
System.err.println(" Cause: " + current.getCause());
current = current.getNextException();
index++;
} while (current != null);
}
注意事项与常见陷阱
实际使用中容易忽略的关键点：
-
getNextException() 返回 null 表示链结束，不可用
hasNext()或类似判断 - 异常链中的每个 SQLException 都是独立对象，
getCause()可能为 null，不要混淆 cause 和 nextException - 某些 JDBC 驱动（如旧版 MySQL Connector/J）对异常链支持不完整，可能只返回第一个异常；建议升级到较新版本（如 MySQL 8.0+ 驱动）
- 日志记录时建议同时输出
getSQLState()和getErrorCode()，这对定位数据库侧具体错误类型（如唯一约束冲突、锁超时）更有效
封装成工具方法（可选）
便于复用，返回所有关联异常列表：
public static List<SQLException> getAllSQLExceptions(SQLException e) {
List<SQLException> list = new ArrayList<>();
SQLException current = e;
while (current != null) {
list.add(current);
current = current.getNextException();
}
return list;
}
调用后可统一分析、过滤或格式化输出，比如只保留 SQLState 以 "23" 开头的约束类错误。
