SQLException是Java中处理数据库错误的关键异常，需通过try-catch捕获并利用getMessage()、getSQLState()和getErrorCode()获取详细信息，结合try-with-resources确保资源自动释放，提升程序健壮性。
在Java中操作数据库时，SQLException 是最常见的异常之一。它由JDBC在执行SQL语句过程中发生错误时抛出，比如连接失败、SQL语法错误、数据类型不匹配、主键冲突等。正确捕获和处理 SQLException 对程序的健壮性和可维护性至关重要。
使用try-catch捕获SQLException
最基本的处理方式是通过 try-catch 语句块来捕获 SQLException。所有涉及 JDBC 操作的代码都应放在 try 块中，并在 catch 中处理异常。
try {
Connection conn = DriverManager.getConnection(url, username, password);
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM users");
while (rs.next()) {
System.out.println(rs.getString("name"));
}
} catch (SQLException e) {
System.err.println("数据库操作异常：" + e.getMessage());
System.err.println("SQL状态码：" + e.getSQLState());
System.err.println("错误码：" + e.getErrorCode());
}
获取详细的异常信息
SQLException 提供了多个方法帮助定位问题，合理利用这些信息有助于快速排查错误。
- getMessage()：返回异常的简要描述，通常包含数据库返回的错误消息。
- getSQLState()：返回标准的SQL状态码（5位字母数字），可用于判断错误类别，如 "23505" 表示唯一约束冲突。
- getErrorCode()：返回数据库厂商特定的错误码，例如MySQL中1062表示重复键。
- printStackTrace()：打印完整的调用栈，适合调试，但生产环境建议记录到日志文件。
处理常见SQL异常场景
不同类型的数据库操作可能引发不同的异常，针对性处理能提升用户体验。
立即学习“Java免费学习笔记（深入）”；
- 连接失败：检查URL、用户名、密码是否正确，网络是否通畅。可捕获 CommunicationsException（MySQL）或类似子类。
- SQL语法错误：确保SQL语句格式正确，避免拼写错误或遗漏关键字。
- 空结果集访问：调用 rs.next() 判断是否有数据后再读取字段，避免“无效的游标状态”异常。
- 资源未释放：务必在 finally 块或使用 try-with-resources 关闭 Connection、Statement 和 ResultSet，防止内存泄漏。
推荐使用try-with-resources自动管理资源
Java 7 引入的 try-with-resources 能自动关闭实现了 AutoCloseable 的资源，简化代码并避免资源泄露。
try (Connection conn = DriverManager.getConnection(url, username, password);
PreparedStatement pstmt = conn.prepareStatement("SELECT * FROM users WHERE id = ?");
) {
pstmt.setInt(1, userId);
try (ResultSet rs = pstmt.executeQuery()) {
if (rs.next()) {
System.out.println(rs.getString("name"));
}
}
} catch (SQLException e) {
System.err.println("SQL执行失败：" + e.getMessage());
}
基本上就这些。掌握 SQLException 的捕获与分析方法，结合良好的资源管理习惯，能让Java数据库程序更稳定可靠。
