如何基于Quarkus与Hibernate生成数据库差异SQL迁移文件？

针对你用PostgreSQL+Quarkus+Hibernate ORM，需要替代HBM2DDL生成可编辑的数据库迁移差异SQL的需求，以下是可行的落地方案：

一、Flyway 自动化生成差异SQL #

你之前手动编写Flyway迁移文件效率低，可通过以下步骤简化：

1. 临时修改application.properties，开启HBM2DDL的更新模式：

quarkus.hibernate-orm.database.generation=update
quarkus.hibernate-orm.sql-load-script=none

2. 启动Quarkus Dev模式，Hibernate会自动将实体变更同步到本地开发数据库。
3. 使用PostgreSQL自带的pg_dump导出当前最新数据库结构：

pg_dump -s -f current_schema.sql 你的数据库名

4. 恢复到实体修改前的数据库版本，用同样命令导出旧结构old_schema.sql。
5. 用SQL对比工具（如pgAdmin的结构对比、diff命令行工具）生成两份schema的差异SQL，按照Flyway命名规则（V<版本号>__<描述>.sql）整理成迁移文件。
6. 改回Flyway生产配置：

quarkus.hibernate-orm.database.generation=none
quarkus.flyway.migrate-at-start=true

小技巧：在Quarkus Dev UI的Hibernate ORM页面，可直接查看Hibernate生成的DDL语句，复制这些变更到Flyway迁移文件，省去手动分析实体的步骤。

二、Liquibase 适配Quarkus的自动差异生成 #

你之前集成liquibase-hibernate遇到的问题，是因为未适配Quarkus的Hibernate环境，正确配置步骤：

1. 在pom.xml中添加依赖：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-liquibase</artifactId>
</dependency>
<dependency>
    <groupId>org.liquibase.ext</groupId>
    <artifactId>liquibase-hibernate5</artifactId>
    <version>4.24.0</version> <!-- 选择与Quarkus版本兼容的版本 -->
</dependency>

2. 创建liquibase.properties，复用Quarkus的数据源配置，避免重复编写：

changeLogFile=src/main/resources/db/liquibase/master.xml
driver=org.postgresql.Driver
url=${quarkus.datasource.jdbc.url}
username=${quarkus.datasource.username}
password=${quarkus.datasource.password}
hibernate.liquibase.use_quarkus_metadata=true
hibernate.connection.url=${quarkus.datasource.jdbc.url}
hibernate.connection.username=${quarkus.datasource.username}
hibernate.connection.password=${quarkus.datasource.password}
hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

3. 直接执行Maven命令生成差异：

mvn liquibase:diff

该命令会自动对比当前实体类（通过Hibernate元数据）与数据库的差异，生成对应的changeSet到master.xml中。你可以后续用mvn liquibase:updateSQL将XML转换为SQL文件，或直接使用XML格式的迁移，同时可手动编辑生成的内容确保正确性。

三、Hibernate原生工具生成差异SQL #

如果不想依赖迁移工具集成，可直接用Hibernate原生API生成差异：

1. 编写一个简单的Java类，调用Hibernate的SchemaDiff工具：

import org.hibernate.boot.MetadataSources;
import org.hibernate.boot.registry.StandardServiceRegistry;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
import org.hibernate.tool.hbm2ddl.SchemaDiff;

public class SchemaDiffGenerator {
    public static void main(String[] args) {
        StandardServiceRegistry registry = new StandardServiceRegistryBuilder()
                .configure("META-INF/persistence.xml")
                .build();
        try {
            MetadataSources sources = new MetadataSources(registry);
            // 注册所有需要对比的实体类
            sources.addAnnotatedClass(你的实体类.class);
            // 依次注册其他实体类
            SchemaDiff diff = new SchemaDiff(sources.buildMetadata(), null);
            // 输出差异的ALTER语句
            System.out.println(diff.createAlterScript());
        } finally {
            StandardServiceRegistryBuilder.destroy(registry);
        }
    }
}

2. 运行该类，控制台会输出实体与数据库的差异SQL，直接复制到迁移文件即可。

总结 #

• Flyway适合偏好纯SQL迁移的场景，结合HBM2DDL临时更新+SQL对比工具可大幅提升效率；
• Liquibase配合liquibase-hibernate5扩展，可自动生成迁移脚本（XML/SQL），减少手动编写量；
• Hibernate原生工具适合快速生成差异，无需额外迁移工具配置。

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