Spring Boot为何忽略我的schema.sql文件？

核心原因：Spring Batch自动配置的干扰 #

你引入了spring-boot-starter-batch，Spring Boot 3.x中，Batch的自动初始化机制会优先于通用的spring.sql.init执行逻辑。默认情况下，当使用H2这类嵌入式数据库时，Spring Batch会自动初始化自身的schema，同时会抑制通用schema.sql的执行——这是因为Batch的初始化逻辑会抢占数据源的初始化流程，导致你的自定义schema.sql被跳过。

其他可能的原因 #

• 配置属性冲突：spring.batch.jdbc.initialize-schema默认值（embedded）的优先级高于spring.sql.init.mode=always，会覆盖通用初始化逻辑。
• schema.sql语法错误：如果文件中存在H2不兼容的SQL语法，执行失败后可能被静默忽略，无明显报错提示。
• 数据源权限问题：H2文件路径/tmp/vuls如果没有读写权限，会导致数据库文件创建失败，后续schema.sql自然无法执行。

解决步骤 #

1. 禁用Batch自动初始化schema
   在application配置中添加：

   spring.batch.jdbc.initialize-schema=never
   

   阻止Batch自动初始化自身schema，让spring.sql.init逻辑正常执行你的schema.sql。如果需要Batch的schema，可以将Batch的DDL手动合并到你的schema.sql中。

2. 验证sql.init配置完整性
   若需要显式指定schema文件路径，可添加：

   spring.sql.init.schema-locations=classpath:schema.sql
   

3. 通过日志定位问题
   开启debug日志，查看org.springframework.boot.sql.init和org.springframework.batch.core.repository包下的日志，确认：

   • schema.sql是否被加载
   • SQL语句执行是否存在报错

4. 校验schema.sql语法
   用H2控制台直接执行schema.sql中的语句，确保所有语法符合H2的要求（避免使用MySQL/Oracle等数据库特有的语法）。

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