Grails5中如何在Liquibase执行后运行Hibernate dbCreate update

核心诉求 #

• 技术栈为Liquibase + Grails 5，需要在开发环境调整框架默认执行顺序：等Liquibase所有变更集执行完成后，再运行Hibernate的dbCreate逻辑
• 默认顺序的问题：如果直接将dbCreate配置为update，Hibernate会在Liquibase启动前先完成数据库表的创建、更新，直接导致Liquibase内置的建表语句执行失败，要规避该问题必须编写大量复杂的前置判断逻辑
• 预期开发效率提升：开发阶段可以先自由创建、修改GORM领域类，等所有功能调试通顺后，再编写对应版本的Liquibase changelog，不用在开发中途反复维护变更脚本
• 实现方向预判：可通过调用指定签名的SchemaManagementToolCoordinator.process(...)方法手动触发Hibernate的schema管理逻辑，已有同类成熟方案是在Liquibase执行完成后触发GORM模型的SchemaValidation校验。

实现步骤 #

1. 调整基础配置，关闭Hibernate默认schema自动执行 #

首先修改开发环境的数据源配置，禁用Hibernate默认提前启动的表结构更新逻辑，避免执行顺序冲突：

environments:
  development:
    dataSource:
      dbCreate: none # 关闭默认自动更新，完全手动控制执行时机
    liquibase:
      enabled: true # 保持Liquibase默认启动逻辑

注意：生产环境不要配置后续的自定义监听逻辑，需完全依赖Liquibase做版本化表结构管理，避免出现非预期的结构变更。

2. 注册事件监听器，Liquibase执行完成后手动触发Hibernate更新 #

在grails-app/init/<你的项目包路径>/目录下新建Groovy类，监听Liquibase执行完成的事件，事件触发后手动调用Hibernate的schema更新逻辑，等价于原有dbCreate=update的效果：

import grails.events.annotation.Listener
import org.grails.datastore.mapping.core.Datastore
import org.hibernate.boot.Metadata
import org.hibernate.tool.schema.TargetType
import org.hibernate.tool.schema.spi.*
import org.springframework.beans.factory.annotation.Autowired

import java.util.EnumSet

class PostLiquibaseSchemaUpdater {

    @Autowired
    Datastore datastore

    @Listener(topic = "liquibase.complete")
    void triggerHibernateSchemaUpdate() {
        def sessionFactory = datastore.sessionFactory
        Metadata metadata = sessionFactory.metamodel.metadata
        def serviceRegistry = sessionFactory.serviceRegistry

        // 组装执行配置，等价于dbCreate=update的执行参数
        SchemaManagementTool managementTool = serviceRegistry.getService(SchemaManagementTool)
        ExecutionOptions executionOptions = new ExecutionOptions() {
            @Override
            boolean shouldManageNamespaces() {
                return false
            }

            @Override
            Map getConfigurationValues() {
                return sessionFactory.properties
            }

            @Override
            ExceptionHandler getExceptionHandler() {
                return { problem -> throw problem } as ExceptionHandler
            }
        }

        // 执行表结构增量更新
        SchemaMigrator migrator = managementTool.getSchemaMigrator(metadata.database.properties)
        migrator.doMigration(metadata, executionOptions, EnumSet.of(TargetType.DATABASE)) { true }

        // 如果要使用SchemaManagementToolCoordinator.process(...)统一入口实现，可按方法签名传入对应DelayedSchemaActions实例，即可适配create/update/validate/drop等不同dbCreate模式
    }
}

3. 按需扩展其他dbCreate模式 #

如果需要模拟其他dbCreate的行为，只需要替换对应的Hibernate schema操作组件即可：

• 需要dbCreate=create效果：从SchemaManagementTool获取SchemaCreator实例，调用全量建表逻辑
• 需要dbCreate=create-drop效果：除启动时调用SchemaCreator建表，额外注册应用关闭事件，获取SchemaDropper实例执行删表逻辑
• 需要dbCreate=validate效果：获取SchemaValidator实例执行表结构和领域类的一致性校验，和早期同类校验方案逻辑一致。

开发流程适配 #

配置完成后开发阶段的工作流可以调整为：

• 日常迭代直接新增、修改GORM领域类，启动应用时Liquibase会先执行完所有历史changelog，之后Hibernate自动同步领域类对应的表结构变更到数据库，全程不需要提前写变更脚本
• 功能调试完成准备提交代码时，以dbCreate=none模式启动一次应用，导出当前Hibernate生成的表结构差异，生成正式的Liquibase changelog纳入版本管理即可，不会出现表结构冲突问题。

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