SpringBoot数据库常见错误DataIntegrityViolationException的原因及解决方案
更新时间：2025年07月14日 10:28:06 作者：码农阿豪@新空间
在SpringBoot+MyBatis/MyBatis-Plus开发过程中,数据库操作是核心部分之一,然而,开发者经常会遇到 org.springframework.dao.DataIntegrityViolationException异常本文将通过两个典型案例,深入分析DataIntegrityViolationException的常见原因,并提供完整的解决方案
引言
在 Spring Boot + MyBatis/MyBatis-Plus 开发过程中，数据库操作是核心部分之一。然而，由于 SQL 语法、数据类型不匹配、约束冲突等问题，开发者经常会遇到 org.springframework.dao.DataIntegrityViolationException 异常。
本文将通过两个典型案例，深入分析 DataIntegrityViolationException 的常见原因，并提供完整的解决方案。同时，我们会结合代码示例，帮助读者理解如何避免类似问题。
1. DataIntegrityViolationException 概述
DataIntegrityViolationException 是 Spring 框架在数据库操作失败时抛出的异常，通常由以下原因引起：
- 数据类型不匹配（如字符串插入到 INT 列）
- 数据截断（如超长字符串插入 VARCHAR(10)）
- 违反约束（如 NOT NULL 列插入了 NULL）
- SQL 语法错误（如 UPDATE 语句缺少 WHERE 条件）
接下来，我们通过两个实际案例进行分析。
2. 案例 1：SQL 语法错误导致的数据类型转换异常
问题描述
在执行以下 MyBatis XML 映射的 SQL 时，报错：
org.springframework.dao.DataIntegrityViolationException: ### Error updating database. Cause: com.mysql.cj.jdbc.exceptions.MysqlDataTruncation: Data truncation: Truncated incorrect DOUBLE value: 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...'
错误 SQL：
<update id="updateCookie">
update task_management set cookie = #{cookie}
<if test="creatorId != null">
and creator_id = #{creatorId}
</if>
</update>
问题分析
错误原因：
- SQL 语句缺少
WHERE关键字，导致and creator_id = #{creatorId}被解析为cookie = (#{cookie} and creator_id = #{creatorId})。 - MySQL 尝试将 JWT Token（字符串）和
creatorId进行逻辑运算，导致类型转换失败。
错误 SQL 实际执行情况：
-- 错误的 SQL
UPDATE task_management SET cookie = ('eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...' AND creator_id = 123);
-- 正确的 SQL 应该是
UPDATE task_management SET cookie = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...' WHERE creator_id = 123;
解决方案
方法 1：使用 <where> 标签
<update id="updateCookie">
UPDATE task_management
SET cookie = #{cookie}
<where>
<if test="creatorId != null">
AND creator_id = #{creatorId}
</if>
</where>
</update>
方法 2：使用 <trim> 标签
<update id="updateCookie">
UPDATE task_management
SET cookie = #{cookie}
<trim prefix="WHERE" prefixOverrides="AND">
<if test="creatorId != null">
AND creator_id = #{creatorId}
</if>
</trim>
</update>
方法 3：使用注解方式
@Update("<script>" +
"UPDATE task_management SET cookie = #{cookie}" +
"<where>" +
" <if test='creatorId != null'>AND creator_id = #{creatorId}</if>" +
"</where>" +
"</script>")
void updateCookie(@Param("cookie") String cookie, @Param("creatorId") Long creatorId);
最佳实践
- 始终在 UPDATE/DELETE 语句中使用 WHERE 条件，避免全表更新。
- 使用 MyBatis 动态 SQL 标签（
<where>、<trim>）防止语法错误。 - 启用 SQL 日志，检查实际执行的 SQL：
logging.level.org.mybatis=DEBUG
3. 案例 2：数据截断错误（Data Truncation）
问题描述
在插入数据时，报错：
org.springframework.dao.DataIntegrityViolationException: ### Error updating database. Cause: java.sql.SQLException: Data truncated for column 'match_status' at row 1
错误 SQL：
INSERT INTO customer_order (match_status) VALUES ('pending_verification');
问题分析
可能原因：
match_status是ENUM，但插入了不在枚举列表的值。match_status是TINYINT，但插入了字符串或超出范围的值（如 256）。match_status是VARCHAR(10)，但插入了超长字符串（如"pending_verification"）。
排查方法：
- 查看表结构：
DESC customer_order;
- 检查
match_status列的定义：
SHOW CREATE TABLE customer_order;
解决方案
情况 1：match_status 是 ENUM
如果 match_status 是 ENUM('pending', 'success', 'failed')，则只能插入这三个值之一：
ALTER TABLE customer_order
MODIFY COLUMN match_status ENUM('pending', 'success', 'failed') NOT NULL;
代码调整：
customerOrder.setMatchStatus("success"); // 正确
// customerOrder.setMatchStatus("invalid_status"); // 错误
情况 2：match_status 是 TINYINT
如果 match_status 是 TINYINT（0-255），则不能插入字符串或超出范围的值：
ALTER TABLE customer_order MODIFY COLUMN match_status TINYINT UNSIGNED NOT NULL DEFAULT 0;
代码调整：
customerOrder.setMatchStatus(1); // 正确
// customerOrder.setMatchStatus(256); // 错误（超出范围）
// customerOrder.setMatchStatus("pending"); // 错误（类型不匹配）
情况 3：match_status 是 VARCHAR 但长度不足
如果 match_status 是 VARCHAR(10)，但插入了更长的字符串：
ALTER TABLE customer_order MODIFY COLUMN match_status VARCHAR(50); -- 扩大长度
代码调整：
customerOrder.setMatchStatus("pending"); // 正确
// customerOrder.setMatchStatus("pending_verification"); // 可能被截断
最佳实践
- 在数据库设计阶段明确字段类型和约束。
- 在代码中校验数据是否符合数据库约束。
- 使用日志监控 SQL 执行情况：
logging.level.org.springframework.jdbc=DEBUG
4. 总结与预防措施
| 问题类型 | 错误示例 | 解决方案 |
|---|---|---|
| SQL 语法错误 | UPDATE ... SET col = val AND ... | 使用 <where> 标签 |
| ENUM 不匹配 | 插入不在枚举列表的值 | 修改数据库或代码 |
| 数值超出范围 | TINYINT 插入 256 | 检查数据库范围 |
| 字符串超长 | VARCHAR(10) 插入 20 字符 | 扩大列长度或截断数据 |
通用调试技巧
查看数据库表结构：
DESC table_name; SHOW CREATE TABLE table_name;
启用 SQL 日志：
logging.level.org.mybatis=DEBUG logging.level.org.springframework.jdbc=DEBUG
在代码中校验数据：
if (value.length() > 10) {
throw new IllegalArgumentException("字段超长");
}
5. 结语
DataIntegrityViolationException 是 Spring Boot 开发中常见的数据库异常，通常由 SQL 语法错误、数据类型不匹配或约束冲突引起。通过本文的分析和解决方案，希望读者能够更高效地定位和修复类似问题。
关键点回顾：
- SQL 语法检查：确保 UPDATE/DELETE 语句有正确的 WHERE 条件。
- 数据类型匹配：确保 Java 代码传入的值与数据库列类型一致。
- 约束校验：避免插入 NULL、超长或不符合 ENUM 的值。
以上就是SpringBoot数据库常见错误DataIntegrityViolationException的原因及解决方案的详细内容，更多关于SpringBoot数据库错误DataIntegrityViolationException的资料请关注脚本之家其它相关文章！
相关文章
本篇文章主要介绍了Spring重试支持Spring Retry的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2018-04-04
这篇文章主要介绍了解读String字符串导致的JVM内存泄漏问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2023-07-07
本文主要介绍了MyBatisPlus之id生成策略的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2023-03-03
这篇文章主要介绍了Java设计模式中的建造者模式详解,建造者模式使我们日常工作中比较常见的一种设计模式,和工厂模式一样属于创建型设计模式,用于解耦对象创建和对象使用的逻辑,需要的朋友可以参考下2023-12-12
今天给大家整理的文章是SpringBoot邮件任务的相关知识点,文中有非常详细的介绍及代码示例,对正在学习SpringBoot任务的小伙伴们很有帮助,需要的朋友可以参考下2021-06-06
在实际项目当中，若能熟练使用Java8 的Stream流特性进行开发，就比较容易写出简洁优雅的代码。本文主要就是基于实际项目常用的Stream Api流式处理总结，希望对大家有所帮助2023-04-04
门面模式又叫外观模式（Facade Pattern），主要用于隐藏系统的复杂性，并向客户端提供了一个客户端可以访问系统的接口，本文通过实例代码给大家介绍下java门面模式的相关知识，感兴趣的朋友一起看看吧2022-02-02
文件上传是许多项目都有的功能,用户上传小文件速度一般都很快,但如果是大文件几个g,几十个g的时候,上传了半天,马上就要完成的时候,网络波动一下,文件又要重新上传,所以本文给大家介绍了Java实现浏览器大文件上传的示例,需要的朋友可以参考下2024-07-07
这篇文章主要为大家详细介绍了java获取本月日历表的方法，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-06-06
这篇文章主要介绍了JavaBean实体类处理外键过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-07-07
最新评论