Spring Boot 2.5.0+中Liquibase创建数据库Schema失败问题求助

问题背景 #

Spring Boot 2.5.0以下版本使用spring.datasource.initialization-mode=always配合schema.sql创建PostgreSQL Schema，同时配置Liquibase使用该Schema。升级到2.5.0+后替换为spring.sql.init.mode=always，但出现Liquibase启动失败的问题：要么提示无可用Schema创建锁表，要么直接报错Schema不存在。目前只能通过首次启动关闭Liquibase来创建Schema，需要更优雅的解决方案。

可行解决方案 #

方案1：将Schema创建逻辑移至Liquibase变更日志 #

直接在Liquibase的主变更日志中添加Schema创建语句，让Liquibase自行处理Schema初始化，避免执行顺序冲突：

1. 修改db/changelog/db.changelog-master.xml，在最顶部添加变更集：

<changeSet id="init-schema" author="your-team">
    <sql>CREATE SCHEMA IF NOT EXISTS myschema;</sql>
</changeSet>

2. 移除项目中的schema.sql文件，保持以下配置：

spring.sql.init.mode=always
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb?currentSchema=myschema
spring.datasource.username=root
spring.datasource.password=pass
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml
spring.liquibase.default-schema=myschema
spring.liquibase.liquibase-schema=myschema

Liquibase启动时会先执行Schema创建语句，确保后续锁表和变更日志表能正常创建。

方案2：通过数据源连接初始化SQL提前创建Schema #

利用HikariCP的连接初始化SQL，在建立数据库连接阶段就创建Schema，确保Liquibase运行时Schema已存在：
修改application.properties，添加Hikari连接初始化配置：

spring.sql.init.mode=always
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb?currentSchema=myschema
spring.datasource.username=root
spring.datasource.password=pass
spring.datasource.hikari.connection-init-sql=CREATE SCHEMA IF NOT EXISTS myschema;
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml
spring.liquibase.default-schema=myschema
spring.liquibase.liquibase-schema=myschema

该SQL会在每个新连接建立时执行，保证Schema始终存在，无需依赖schema.sql的执行顺序。

方案3：延迟Liquibase启动，等待SQL初始化完成 #

通过事件监听机制，让Liquibase在spring.sql.init完成后再启动：

1. 先在配置中禁用Liquibase自动启动：

spring.sql.init.mode=always
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb?currentSchema=myschema
spring.datasource.username=root
spring.datasource.password=pass
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml
spring.liquibase.default-schema=myschema
spring.liquibase.liquibase-schema=myschema
spring.liquibase.enabled=false

2. 创建事件监听类，监听数据源初始化完成事件并启动Liquibase：

import liquibase.integration.spring.SpringLiquibase;
import org.springframework.boot.context.event.DataSourceInitializedEvent;
import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;

@Component
public class LiquibasePostInitStartup implements ApplicationListener<DataSourceInitializedEvent> {

    private final SpringLiquibase liquibase;

    public LiquibasePostInitStartup(SpringLiquibase liquibase) {
        this.liquibase = liquibase;
    }

    @Override
    public void onApplicationEvent(DataSourceInitializedEvent event) {
        try {
            liquibase.setShouldRun(true);
            liquibase.afterPropertiesSet();
        } catch (Exception ex) {
            throw new RuntimeException("Failed to initialize Liquibase after data source setup", ex);
        }
    }
}

这样schema.sql执行完成后，Liquibase才会启动，确保Schema已创建。

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