Java中JDBC查询异常处理需捕获SQLException，利用getMessage()、getSQLState()、getErrorCode()和getNextException()诊断问题，配合try-with-resources释放资源，并分层捕获子类异常，空结果集不视为错误。
Java 中 JDBC 处理数据库查询异常，核心是正确捕获 SQLException，并结合资源管理、错误诊断和业务响应三个层面来保障程序稳定性和可维护性。
捕获并解析 SQLException 的关键信息
查询异常（如表不存在、字段名错误、权限不足、网络中断）都会抛出 SQLException。它不是运行时异常，必须显式处理。重点利用以下方法获取上下文：
- getMessage()：获取可读的错误描述，适合日志记录或用户提示（如“Unknown column 'agee' in field list”）
- getSQLState()：返回标准五位码（如“42S22”表示列未找到，“08001”表示连接拒绝），便于统一分类处理
- getErrorCode()：返回数据库厂商特有码（如 MySQL 的 1054、Oracle 的 ORA-00904），可用于精准识别约束或语法问题
- getNextException()：当批量查询或事务中出现多个失败时，可遍历链式异常获取全部细节
用 try-with-resources 自动释放资源
查询后必须关闭 ResultSet、Statement 和 Connection，否则易导致连接泄漏。手动在 finally 中关闭冗长且易错，应优先使用 try-with-resources：
示例：
String sql = "SELECT name, email FROM users WHERE id = ?";
try (Connection conn = DriverManager.getConnection(url, user, pass);
PreparedStatement ps = conn.prepareStatement(sql);
ResultSet rs = ps.executeQuery()) {
if (rs.next()) {
System.out.println(rs.getString("name"));
} else {
System.out.println("未查到数据");
}
} catch (SQLException e) {
String state = e.getSQLState();
if ("42S22".equals(state)) {
log.error("SQL 字段错误，请检查查询语句", e);
} else if ("08001".equals(state)) {
log.warn("数据库连接不可用，触发降级逻辑");
} else {
log.error("查询异常", e);
}
}
区分异常类型，避免“一锅炖”式捕获
不要只写 catch (SQLException e) 就完事。实际开发中常遇到子类异常，应分层捕获提升可维护性：
- SQLSyntaxErrorException：SQL 语法或对象名错误，属开发阶段问题，需立即修正
- SQLTimeoutException：查询超时，可能需优化 SQL 或调整 fetchSize
- SQLNonTransientConnectionException：连接永久性失败（如数据库宕机），应触发重试或告警
- SQLRecoverableException：临时性失败（如网络抖动），适合有限重试
捕获顺序要由具体到宽泛，防止子类被父类提前截获。
空结果集不等于异常，别误判为错误
查询返回 0 行是正常业务场景（如查一个不存在的用户），不是 SQLException。错误做法是把 rs.next() == false 当作异常处理。正确方式是：
- 用
rs.isBeforeFirst()+rs.getRow() == 0判断是否真为空（仅对可滚动 ResultSet 有效） - 更通用的做法：执行
rs.next()后，若为false，说明无数据；若为true，再用do-while或循环处理——注意游标已就位，第一条数据不会丢失 - 避免调用
rs.last(); int size = rs.getRow(); rs.beforeFirst();，性能差且部分驱动不支持
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
