java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > SpringBoot数据库错误DataIntegrityViolationException

SpringBoot数据库常见错误DataIntegrityViolationException的原因及解决方案

作者：码农阿豪@新空间

在SpringBoot+MyBatis/MyBatis-Plus开发过程中,数据库操作是核心部分之一,然而,开发者经常会遇到 org.springframework.dao.DataIntegrityViolationException异常本文将通过两个典型案例,深入分析DataIntegrityViolationException的常见原因,并提供完整的解决方案

引言

在 Spring Boot + MyBatis/MyBatis-Plus 开发过程中，数据库操作是核心部分之一。然而，由于 SQL 语法、数据类型不匹配、约束冲突等问题，开发者经常会遇到 org.springframework.dao.DataIntegrityViolationException 异常。

本文将通过两个典型案例，深入分析 DataIntegrityViolationException 的常见原因，并提供完整的解决方案。同时，我们会结合代码示例，帮助读者理解如何避免类似问题。

1. DataIntegrityViolationException 概述

DataIntegrityViolationException 是 Spring 框架在数据库操作失败时抛出的异常，通常由以下原因引起：

  1. 数据类型不匹配（如字符串插入到 INT 列）
  2. 数据截断（如超长字符串插入 VARCHAR(10)）
  3. 违反约束（如 NOT NULL 列插入了 NULL）
  4. 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 实际执行情况：

-- 错误的 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);

最佳实践

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');

问题分析

可能原因：

排查方法：

DESC customer_order;

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"); // 可能被截断

最佳实践

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 语法错误、数据类型不匹配或约束冲突引起。通过本文的分析和解决方案，希望读者能够更高效地定位和修复类似问题。

关键点回顾：

  1. SQL 语法检查：确保 UPDATE/DELETE 语句有正确的 WHERE 条件。
  2. 数据类型匹配：确保 Java 代码传入的值与数据库列类型一致。
  3. 约束校验：避免插入 NULL、超长或不符合 ENUM 的值。

以上就是SpringBoot数据库常见错误DataIntegrityViolationException的原因及解决方案的详细内容，更多关于SpringBoot数据库错误DataIntegrityViolationException的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文