Spring Boot数据初始化异常：ddl-auto设为update时出现重复条目问题

你遇到的问题核心在于Spring Boot的数据源初始化机制和Hibernate的ddl-auto配置是完全独立的两个流程：

• 当你设置datasource.initialization=always时，Spring Boot会在每次应用启动时无条件执行data.sql里的插入语句，不管数据库表结构有没有变化。
• 而spring.jpa.hibernate.ddl-auto=update的作用仅仅是让Hibernate根据实体类更新表结构（比如新增字段、修改字段类型），但它不会清空已有的数据，也不会干预Spring Boot执行data.sql的行为。

所以当你第一次启动应用时，Hibernate创建表，Spring Boot插入数据；第二次启动（或修改应用重启）时，Hibernate检测到表结构无需修改就啥也不做，但Spring Boot还是会再次执行data.sql，往已经有数据的表里插重复条目，自然就触发了MySQLIntegrityConstraintViolationException。

针对这个问题，有几种常用的解决思路，你可以根据自己的业务场景选择：

1. 调整数据源初始化策略 #

把datasource.initialization的值从always改成create-only：

spring.sql.init.mode=create-only

这个配置的作用是：只有当Hibernate创建新表的时候（也就是第一次启动，或者你手动清空数据库后启动），Spring Boot才会执行data.sql插入初始数据。后续启动时，因为表已经存在，就不会再执行插入操作，从根源上避免重复。

2. 修改data.sql的插入逻辑 #

如果必须保持datasource.initialization=always，可以修改data.sql里的插入语句，让它能处理重复条目：

• 使用INSERT IGNORE INTO：如果遇到重复的主键/唯一约束，就忽略这条插入，不会报错

  INSERT IGNORE INTO your_table (id, name) VALUES (1, 'test');
  

• 使用REPLACE INTO：如果遇到重复条目，就删除原条目再插入新的（注意：这会覆盖已有数据，需要确认业务逻辑允许）

  REPLACE INTO your_table (id, name) VALUES (1, 'updated-test');
  

3. 区分环境配置（推荐生产环境使用） #

在开发环境和生产环境用不同的配置组合：

• 开发环境：datasource.initialization=always + ddl-auto=create，方便每次重启都能拿到干净的测试数据
• 生产环境：datasource.initialization=never + ddl-auto=update，避免误操作插入重复数据，同时保证表结构能更新

你可以用Spring Boot的Profile功能来实现环境切换，比如创建application-dev.properties和application-prod.properties分别配置。

4. 改用Hibernate的import.sql #

如果你想让数据初始化和Hibernate的DDL操作绑定，可以把初始数据放到import.sql文件里，而不是data.sql。Hibernate的规则是：

• 当ddl-auto=create或create-drop时，会执行import.sql
• 当ddl-auto=update时，不会执行import.sql
  这样就不会出现重复插入的问题，但要注意import.sql是Hibernate的机制，和Spring Boot的data.sql是分开的。

内容的提问来源于stack exchange，提问作者Eric Huang