Spring Boot启动时如何从resource目录SQL脚本初始化PostgreSQL数据库

你遇到的无报错但脚本不执行的问题，核心原因是Spring Boot默认仅对H2、HSQL这类嵌入式内存数据库自动开启SQL初始化能力，PostgreSQL作为独立部署的数据库需要显式开启初始化配置，同时要处理好SQL脚本和JPA/Hibernate的执行顺序。 #

具体配置步骤 #

1. 追加核心初始化配置 #

在你现有application.properties配置基础上，补充以下内容：

# 强制开启SQL初始化（非嵌入式数据库必须配置，默认值为embedded仅对内存库生效）
spring.sql.init.mode=always
# 按文件名规则匹配resource目录下01-06的SQL脚本，Spring会自动按照文件名自然排序依次执行
# 如果你把脚本放在resource/sql这类子目录下，路径改为classpath:sql/0*.sql即可
spring.sql.init.schema-locations=classpath:0*.sql
# 脚本执行账号密码和数据源保持一致，和你现有配置对齐
spring.sql.init.username=postgres
spring.sql.init.password=docker
# 脚本执行遇到错误直接中断抛出，避免半初始化状态，开发调试阶段可临时设为true跳过错误
spring.sql.init.continue-on-error=false
# 关键配置：控制JPA和SQL脚本的执行顺序
# 如果你完全用自定义SQL脚本维护表结构，直接关闭Hibernate的自动建表能力
spring.jpa.hibernate.ddl-auto=none
# 如果你需要Hibernate先自动生成基础表结构，再执行你的自定义脚本做补充修改/数据插入
# 请把ddl-auto设为update/create，同时开启下面的延迟初始化配置
# spring.jpa.defer-datasource-initialization=true

2. 脚本合规性校验 #

• 你当前使用01.sql到06.sql的两位数字命名是正确的，能保证文件名排序和执行顺序完全一致，不要使用1.sql/2.sql这类单位数命名，后续新增序号10及以上的脚本时会出现排序错乱
• 脚本内不要写入psql客户端专属命令（比如\c 库名这类斜杠开头的指令），所有语句必须是标准JDBC可执行的SQL，语句末尾用分号分隔
• 如果脚本包含数据插入逻辑，不要把建表语句和插入语句拆分到不同匹配规则的路径下，统一放在schema-locations匹配的路径里按顺序执行即可

3. 执行过程调试 #

如果需要确认脚本加载执行情况，追加日志配置即可在控制台看到每个脚本的执行明细：

logging.level.org.springframework.jdbc.datasource.init=debug

常见踩坑说明 #

如果配置后还是出现脚本不重复执行的情况，检查数据库里是否存在SPRING_SQL_INIT记录表，这个表是Spring Boot用来记录已经执行过的脚本版本的，修改脚本后需要手动删除该表，或者把spring.sql.init.mode设为always就会每次启动都强制执行脚本。

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