0

0

在Java中数据库异常应该如何封装_Java数据访问异常解析

P粉602998670

P粉602998670

发布时间:2026-01-16 10:59:16

|

275人浏览过

|

来源于php中文网

原创

不该直接抛出sqlexception。应捕获后转为自定义异常或spring的dataaccessexception子类,通过sqlexceptiontranslator统一映射为语义明确的运行时异常,并提取sqlstate、errorcode等字段精准判别错误类型。

在java中数据库异常应该如何封装_java数据访问异常解析

Java中SQLException该不该直接抛出

不应该。直接抛出 SQLException 会把数据库驱动细节(比如 MySQL 的 CommunicationsException、Oracle 的 SQLRecoverableException)暴露到业务层,破坏分层隔离,也导致上层无法区分是连接失败、超时还是语法错误。

典型错误写法:

public User findById(int id) throws SQLException {
    String sql = "SELECT * FROM user WHERE id = ?";
    try (PreparedStatement ps = conn.prepareStatement(sql)) {
        ps.setInt(1, id);
        ResultSet rs = ps.executeQuery();
        // ...
    }
}

正确做法是捕获后转为自定义异常或 Spring 的 DataAccessException 子类。JDBC 规范本身不强制要求统一异常类型,各驱动实现差异大,必须封装。

Spring JDBC 中如何统一处理 SQL 异常

依赖 Spring 的 org.springframework.dao 异常体系,它通过 SQLExceptionTranslator 将原生 SQLException 映射为语义明确的运行时异常,如:

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

  • DuplicateKeyException → 主键/唯一约束冲突
  • DataIntegrityViolationException → 外键、非空、检查约束失败
  • CannotAcquireLockException → 行锁等待超时(MySQL 的 LockWaitTimeoutException
  • UncategorizedSQLException → 未被映射的底层错误,需查 getRootCause()

使用要点:

Video Ocean
Video Ocean

人人皆导演,让视频创作变得轻松自如

下载
  • 确保配置了 DataSourceJdbcTemplate,Spring 会自动注册默认 translator
  • 若用 MyBatis,需启用 spring.datasource.hikari.data-source-properties.useSSL=false 类似参数避免 SSL 相关异常被误判
  • 自定义 translator 需继承 SQLStateSQLExceptionTranslatorSQLExceptionTranslator 接口

手动封装 SQLException 的关键字段提取

当不用 Spring,或需在 DAO 层做精细控制时,应从 SQLException 中提取三个核心字段判断问题类型:

  • getSQLState():标准 SQL 状态码(如 "23000" 表示完整性约束违规)
  • getErrorCode():数据库厂商专属码(MySQL 是纯数字,如 1062;PostgreSQL 是五位字符串)
  • getLocalizedMessage():带上下文的提示,但不可用于逻辑分支判断(内容不稳定)

示例判断逻辑:

if ("23000".equals(ex.getSQLState()) || ex.getErrorCode() == 1062) {
    throw new UserAlreadyExistsException("用户名已存在");
} else if (ex.getErrorCode() == 1205) { // MySQL deadlock
    throw new RetryableDataAccessException("死锁,请重试", ex);
}

注意:不要只依赖 getMessage() 做匹配,不同驱动版本返回消息格式可能变化。

连接池异常和事务回滚的常见误判点

HikariCP、Druid 等连接池抛出的异常往往不是 SQLException,而是包装后的运行时异常,容易漏处理:

  • HikariPool$PoolInitializationException:数据源初始化失败(URL 错、权限不足)
  • SQLTimeoutException:查询超时,但它是 SQLException 子类,可被 translator 捕获
  • TransactionSystemException:Spring 事务管理器包装的底层异常,需调用 getCause().getCause() 才能拿到原始 SQLException

事务中发生异常时,仅捕获 SQLException 不够——必须确认是否已触发回滚。Spring 默认只对 RuntimeException 回滚,而 SQLException 是检查异常,若未声明 @Transactional(rollbackFor = SQLException.class),事务不会回滚。

真正难缠的是网络闪断导致的半开连接:连接池可能返回一个已失效的 Connection,首次执行时才抛 CommunicationsException,此时事务早已开始,需靠连接池的 connection-test-queryvalidation-timeout 提前探测。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1133

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

381

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2152

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

380

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1663

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

440

2024.04.29

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

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

共48课时 | 2.5万人学习

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

共3课时 | 0.3万人学习

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

共1课时 | 846人学习

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

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