Spring Boot（Hibernate）无法添加数据库初始数据的技术问询

问题根源分析 #

1. create-drop模式下的外键错误：create-drop会在应用关闭时删除所有表，但spring.sql.init.mode=always的初始化逻辑和Hibernate的DDL销毁时序冲突——Hibernate尝试删除user_role的外键时，该表可能已经被初始化脚本的后续操作（或Hibernate自身的销毁流程）处理过，导致找不到外键报错。
2. update模式下数据不插入：Hibernate默认只在create/create-drop模式执行import.sql，update模式下会跳过这个脚本，所以role表没有数据。

可行解决方案 #

方案1：改用Spring Boot原生data.sql（推荐） #

放弃Hibernate的import.sql，改用Spring Boot的初始化脚本机制，时序更可控：

1. 将类路径下的import.sql重命名为data.sql
2. 调整配置文件：

spring.jpa.hibernate.ddl-auto=create-drop
spring.jpa.defer-datasource-initialization=true
spring.sql.init.mode=always
# 可选：如果担心重复插入报错（比如重启应用时），可以开启这个配置
spring.sql.init.continue-on-error=true

原理：defer-datasource-initialization=true会确保Hibernate完成表结构创建后，再执行data.sql的插入逻辑，彻底避免外键相关的时序冲突；create-drop模式下每次启动都会重建表，不用担心数据重复问题。

方案2：保留import.sql，适配update模式 #

如果一定要用Hibernate的import.sql，可以通过配置让update模式也执行脚本：

1. 保留原import.sql文件
2. 修改配置：

spring.jpa.hibernate.ddl-auto=update
spring.jpa.defer-datasource-initialization=true
# 让Hibernate在update模式下也执行import.sql
spring.jpa.properties.hibernate.hbm2ddl.import_files=import.sql
# 处理多行SQL脚本的提取器，避免换行导致执行失败
spring.jpa.properties.hibernate.hbm2ddl.import_files_sql_extractor=org.hibernate.tool.hbm2ddl.MultipleLinesSqlCommandExtractor

原理：通过hibernate.hbm2ddl.import_files指定脚本路径，并用MultipleLinesSqlCommandExtractor正确解析多行SQL，强制Hibernate在update模式下执行初始化插入。

方案3：数据库版本控制工具（进阶） #

如果项目需要长期维护数据库结构和初始化数据，推荐使用Flyway或Liquibase，它们能更精细地控制DDL和数据初始化的时序，避免各种Hibernate自动DDL带来的冲突问题。

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