0

0

在Java中如何处理SQLException_Java数据库操作异常解析

P粉602998670

P粉602998670

发布时间:2026-01-13 14:51:09

|

282人浏览过

|

来源于php中文网

原创

SQLException是检查异常,必须显式捕获或声明抛出;应在DAO层转换为语义化自定义异常,用getSQLState()和getErrorCode()精准判错,配合try-with-resources管理资源,批量操作需通过BatchUpdateException处理失败。

在java中如何处理sqlexception_java数据库操作异常解析

SQLException 是检查异常,必须显式处理

Java 中 SQLException 继承自 Exception,属于检查异常(checked exception),编译器强制要求捕获或声明抛出。不处理会直接编译失败,不是“运行时看情况”。

  • 不能只靠 IDE 自动生成 try-catch 并吞掉异常(比如空 catch 块),这会让数据库错误静默失败
  • 也不建议在方法签名里无差别加 throws SQLException 向上甩锅,尤其在 service 层——调用方很难合理响应底层 JDBC 错误
  • 推荐在 DAO 层捕获,转换为更语义化的自定义异常(如 DataAccessException),并保留原始 SQLException 作为 cause

通过 getSQLState() 和 getErrorCode() 区分错误类型

SQLExceptiongetSQLState()(标准 SQL 状态码,5 位字符串)和数据库厂商专属的 getErrorCode()(如 MySQL 的 1062、PostgreSQL 的 23505)才是判断错误本质的关键,而不是仅依赖 getMessage() 的文本内容——它可能被本地化或含无关上下文。

  • getSQLState() 遵循 SQL:2003 标准,例如 "23505" 表示唯一约束冲突(PostgreSQL/Oracle 兼容),"23000" 是通用完整性约束违例
  • getErrorCode() 更具体:MySQL 插入重复主键报错是 1062,Oracle 是 1,H2 是 23505
  • 不要用 getMessage().contains("Duplicate") 做判断——字段名、语言、版本都可能导致匹配失效

使用 try-with-resources 确保 ResultSet/Statement/Connection 正确关闭

资源未关闭是引发后续 SQLException(如 “Connection closed”、“Operation not allowed after ResultSet closed”)的常见原因,和事务逻辑无关,纯属资源管理疏漏。

  • ConnectionStatementResultSet 都实现了 AutoCloseable,必须用 try-with-resources,而非手动 finally 调用 close()
  • 避免在同一个 try 块中复用 Statement 执行多个查询——旧 ResultSet 会被自动关闭,再调用其 next() 就抛 SQLException
  • 连接池(如 HikariCP)返回的 Connection 关闭操作实际是归还连接,但依然要 close,否则连接永远不释放
try (Connection conn = dataSource.getConnection();
     PreparedStatement stmt = conn.prepareStatement("SELECT * FROM user WHERE id = ?");
     ResultSet rs = stmt.executeQuery()) {
    while (rs.next()) {
        // 处理结果
    }
} catch (SQLException e) {
    // 处理异常
}

批量操作失败时,getUpdateCounts() 返回值需谨慎解读

调用 executeBatch() 后,getUpdateCounts() 返回 int[],但它的含义容易误解:不是“每个语句影响行数”,而是“执行状态标识”。Statement.EXECUTE_FAILED(值为 -3)表示该条失败,但其他条可能成功;而 -2 表示“未执行”(某些驱动对部分失败不填具体数值)。

新快购物系统
新快购物系统

新快购物系统是集合目前网络所有购物系统为参考而开发,不管从速度还是安全我们都努力做到最好,此版虽为免费版但是功能齐全,无任何错误,特点有:专业的、全面的电子商务解决方案,使您可以轻松实现网上销售;自助式开放性的数据平台,为您提供充满个性化的设计空间;功能全面、操作简单的远程管理系统,让您在家中也可实现正常销售管理;严谨实用的全新商品数据库,便于查询搜索您的商品。

下载

立即学习Java免费学习笔记(深入)”;

  • 不能假设数组长度等于 SQL 条数——某些驱动在遇到第一个失败后就中断,后续条目不计入数组
  • 不同驱动行为不一致:MySQL Connector/J 默认继续执行(可配 continueBatchOnError=false),PostgreSQL 的 pgjdbc 则默认中断
  • 真正可靠的失败定位方式是捕获 BatchUpdateException,它继承自 SQLException,且提供 getUpdateCounts() 和嵌套的原始异常链

JDBC 异常处理最麻烦的点不在语法,而在于同一类错误(比如唯一键冲突)在不同数据库、不同驱动版本下暴露出来的状态码、错误码、甚至异常类型都可能不同。别迷信文档里的“标准”,上线前务必用目标环境的真实数据库跑一遍边界 case。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

832

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

737

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

733

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

3

2026.01.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.7万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 790人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号