Spring Boot中如何正确指定SQL脚本目录（Hibernate场景）

问题分析 #

直接指定目录（如classpath:/sql）导致SQL语法错误的核心原因是：Spring Boot会将目录下所有SQL文件的内容按文件名顺序拼接成一个完整脚本执行，若脚本执行顺序错误（比如先执行数据填充脚本再执行表结构脚本），或脚本内语句分隔符不符合Spring的默认规则，就会触发报错——即便单个脚本在其他环境能正常运行。

可行的简化配置方案 #

方案1：合并指定单个脚本路径（精准控制顺序）

用一行配置同时指定schema.sql和data.sql，Spring会按配置顺序先执行表结构脚本，再执行数据填充脚本：

spring.jpa.hibernate.ddl-auto=none
spring.sql.init.mode=always
spring.sql.init.continue-on-error=true
# 用逗号分隔指定两个脚本，按配置顺序执行
spring.sql.init.locations=classpath:/sql/schema.sql,classpath:/sql/data.sql

方案2：通配符指定目录（需保证脚本执行顺序）

如果目录下有多个脚本，可使用通配符批量指定，但必须通过文件名前缀确保schema类脚本优先执行（比如给结构脚本命名为01_schema.sql，数据脚本命名为02_data.sql）：

spring.jpa.hibernate.ddl-auto=none
spring.sql.init.mode=always
spring.sql.init.continue-on-error=true
# 匹配sql目录下所有SQL文件，按文件名自然排序执行
spring.sql.init.locations=classpath:/sql/*.sql

关键注意事项 #

• 执行顺序优先级：Spring Boot会按spring.sql.init.locations中配置的顺序，或通配符匹配到的文件名顺序执行脚本，必须保证表结构脚本在数据填充脚本之前运行。
• 语句分隔符问题：默认使用;作为SQL语句分隔符，若脚本包含存储过程等含;的特殊语法，需额外配置spring.sql.init.separator指定自定义分隔符（比如|||）。
• 属性覆盖规则：一旦配置了spring.sql.init.locations，单独的spring.sql.init.schema-locations和spring.sql.init.data-locations会被忽略，无需重复配置。

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