Spring Boot通过application.yml连接PostgreSQL时schema.sql不生效无报错如何解决

以下是针对schema.sql未执行问题的排查和修复步骤：

• 调整SQL初始化模式
  Spring Boot 2.5及以上版本默认仅对嵌入式数据库（如H2）自动执行SQL初始化脚本，外置PostgreSQL需要显式开启初始化配置，在application.yml中新增：

spring:
  sql:
    init:
      mode: always

如果使用Spring Boot 2.4及更早版本，配置项改为：

spring:
  datasource:
    initialization-mode: always

• 调整JPA与SQL脚本的执行顺序
  你配置了hibernate.ddl-auto: create-drop，默认Hibernate的DDL操作会晚于schema.sql执行，可能覆盖脚本的执行结果，添加如下配置让schema.sql在Hibernate DDL完成后执行：

spring:
  jpa:
    defer-datasource-initialization: true

• 验证文件路径与命名
  确认schema.sql文件存放在项目src/main/resources根目录下，无拼写错误（如大小写错误、字母顺序错误）。如果要适配platform: postgres配置，也可将脚本重命名为schema-postgres.sql。
• 验证SQL脚本正确性
  将schema.sql内容手动复制到PostgreSQL客户端执行，确认语法无错误，建表语句建议添加IF NOT EXISTS避免因表已存在导致静默执行失败：

CREATE TABLE IF NOT EXISTS 表名 (
  -- 字段定义
);

• 开启调试日志排查
  在配置中添加日志级别配置，查看初始化过程的详细日志定位问题：

logging:
  level:
    org.springframework.jdbc.datasource.init: DEBUG

修改后的完整application.yml参考：

spring:
  sql:
    init:
      mode: always
  jpa:
    database: postgresql
    show-sql: true
    hibernate:
      ddl-auto: create-drop
    defer-datasource-initialization: true
  datasource:
    schema: classpath:/schema.sql
    platform: postgres
    url: jdbc:postgresql://localhost:5432/db
    username: postgres
    password: postgres
    driverClassName: org.postgresql.Driver

内容的提问来源于stack exchange，提问作者Дмитрий Фактов