为何Spring Boot中spring.sql.init相关配置未因缺失MySQL脚本报错？

核心原因：Spring Boot 3.1.x spring.sql.init的默认行为 #

Spring Boot的SQL初始化模块（spring-boot-autoconfigure下的SqlInitializationAutoConfiguration）默认逻辑是：

• 当设置spring.sql.init.mode=always时，会按优先级尝试加载脚本：
  1. 先加载schema-${platform}.sql和data-${platform}.sql（由spring.sql.init.platform指定）
  2. 如果找不到上述平台专属脚本，会尝试加载通用的schema.sql和data.sql
  3. 如果两类脚本都不存在，初始化流程直接跳过，不会抛出任何错误
• 即使spring.sql.init.platform设置为不存在的标识（比如mysqlabc），逻辑依然是：找不到对应平台脚本→尝试通用脚本→都找不到则跳过，无报错。

触发"找不到脚本报错"的配置方案 #

如果需要在缺失初始化脚本时强制报错（符合预生产环境的严谨性要求），需添加以下配置到application-mysql.properties：

1. 明确指定必须加载的脚本路径 #

通过spring.sql.init.schema-locations和spring.sql.init.data-locations指定具体的脚本文件，确保Spring Boot会检查文件是否存在：

# 强制指定加载平台专属脚本，不存在则报错
spring.sql.init.schema-locations=classpath:schema-mysql.sql
spring.sql.init.data-locations=classpath:data-mysql.sql

2. 开启执行错误时终止启动（预生产环境建议开启） #

确保脚本执行过程中出现错误时直接终止应用启动，避免脏数据：

spring.sql.init.fail-on-error=true

额外验证点 #

• 检查是否存在自定义的DataSourceInitializer或其他初始化Bean，覆盖了默认的SQL初始化流程
• 确认spring-boot-starter-jdbc依赖是否正确引入，确保SQL初始化自动配置类（SqlInitializationAutoConfiguration）被正常加载

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