使用R2DBC与Liquibase时，如何确保Liquibase先于R2DBC操作执行完毕？

安全阿岳

2026-8-20

解决R2DBC场景下@PostConstruct早于Liquibase执行的问题

核心问题原因

在R2DBC的反应式环境中，Liquibase的数据库迁移是异步执行的，而@PostConstruct是同步触发的初始化逻辑，这就导致你的自定义初始化方法会在数据库迁移完成前提前运行。

可行解决方案

方法1：依赖Liquibase R2DBC的默认Bean

如果使用Spring Boot自动整合Liquibase R2DBC，直接让你的业务Bean依赖liquibaseR2dbc这个默认Bean即可：

@DependsOn("liquibaseR2dbc")
@Component
public class YourBusinessBean {
    @PostConstruct
    public void init() {
        // 此处逻辑会在Liquibase迁移完成后执行
    }
}

注意：如果你自定义了Liquibase的配置Bean，需要替换为你自己声明的Bean名称。

方法2：监听Liquibase迁移完成事件

这种方式更适配反应式环境的异步特性，无需依赖特定Bean名称，直接通过事件驱动触发初始化：

@Component
public class MigrationCompletionHandler {

    @EventListener
    public void handleMigrationComplete(LiquibaseMigrationCompletedEvent event) {
        // 数据库迁移完成后执行你的初始化逻辑
    }
}

方法3：手动绑定Liquibase Bean依赖

如果是手动配置Liquibase，先在配置类中显式声明Liquibase R2DBC Bean：

@Configuration
public class LiquibaseConfig {

    @Bean
    public LiquibaseR2dbc liquibaseR2dbc(ConnectionFactory connectionFactory) {
        return new LiquibaseR2dbc(
                "classpath:db/changelog/db.changelog-master.yaml",
                new ClassLoaderResourceAccessor(),
                connectionFactory
        );
    }
}

然后在业务类上添加@DependsOn("liquibaseR2dbc")，确保初始化逻辑在Liquibase Bean完全初始化后执行。