Spring Boot 2.0引入spring-cloud-starter-config后schema.sql无法执行

阿华AIGC实验室

2026-5-25

Spring Boot 2.0添加Config Client后schema.sql不执行的解决办法

问题复现

按照你描述的步骤：

用Spring Initializr生成Spring Boot 2.0.1应用，引入web、rest repositories、jpa、h2、config client依赖
添加Room JPA实体类
将schema.sql放在classpath下
启动应用后发现H2数据库并未被schema.sql初始化

原因分析

我之前也碰到过类似的问题，核心原因是Spring Cloud Config Client的启动逻辑改变了应用的配置加载顺序：默认情况下，Config Client会在应用上下文初始化之前先从配置服务器拉取远程配置，这直接干扰了Spring Boot默认的嵌入式数据库初始化流程。原本Spring Boot会自动识别嵌入式H2数据库，并触发schema.sql执行，但Config Client引入后，配置加载的优先级和时机发生变化，导致自动执行脚本的条件不再满足，或者相关配置被远程配置意外覆盖。

解决方案

这里有几个可靠的解决办法，你可以逐一尝试：

1. 显式指定数据库初始化模式

在bootstrap.properties（注意是bootstrap而非application，它的加载优先级更高）里添加：

spring.datasource.initialization-mode=embedded
spring.datasource.platform=h2

initialization-mode=embedded会强制Spring Boot对嵌入式数据库执行初始化脚本，明确告诉应用要执行schema.sql；platform=h2指定脚本对应的数据库类型，避免自动识别出错。

2. 显式指定schema.sql路径

如果自动扫描不到脚本，可以手动指定路径，在bootstrap.properties里补充：

spring.datasource.schema=classpath:schema.sql

这样应用会精准加载你指定的初始化脚本，不会因为配置加载顺序问题错过它。

3. 确保本地配置优先级高于远程配置

如果你的Config Server上的配置覆盖了数据源初始化相关属性，可以让本地bootstrap配置优先生效，添加：

spring.cloud.config.override-none=true

这个配置会让本地配置覆盖远程配置，避免远程配置里的initialization-mode等属性把你的本地设置冲掉。

4. 调整自动配置的顺序（进阶）

如果上面的方法都不行，可以通过注解调整DataSourceAutoConfiguration的加载顺序，确保它在Config Client配置加载完成后执行。在你的启动类上添加：

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
@Import(DataSourceAutoConfiguration.class)
@DependsOn("configDataContextRefresher")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

不过这个方法比较进阶，一般前三个方法就能解决问题，优先尝试前面的。