liquibaseGenerateChangelog从JPA实体生成变更集时无内容的问题

我有一个基于Gradle的项目，包含多个JPA实体类。目前还没创建数据库，想生成XML格式的Liquibase changesets用来初始化空数据库的表结构。但执行liquibaseGenerateChangelog Gradle任务后，虽然指定了实体类所在包，生成的XML变更集文件里却没有任何changesets。

执行的命令：

./gradlew liquibaseGenerateChangelog
--changeLogFile=src/main/resources/config/liquibase/master.xml
--url=hibernate:spring:com.company.project.domain?dialect=liquibase.ext.hibernate.database.HibernateGenericDialect
--driver=liquibase.ext.hibernate.database.connection.HibernateDriver

生成的空变更集文件内容：

<?xml version="1.1" encoding="UTF-8" standalone="no"?>
<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext" xmlns:pro="http://www.liquibase.org/xml/ns/pro" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd http://www.liquibase.org/xml/ns/pro http://www.liquibase.org/xml/ns/pro/liquibase-pro-4.1.xsd http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.1.xsd"/>

实体类示例（com.company.project.domain包下）：

@Entity
@Table(name = "user")
public class User implements Serializable {

  private static final long serialVersionUID = 1L;

  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "sequenceGenerator")
  @SequenceGenerator(name = "sequenceGenerator")
  private Long id;

  // 其他字段和方法
}

build.gradle相关依赖配置：

// ...
implementation "org.hibernate:hibernate-core"
implementation "org.liquibase:liquibase-core"
liquibaseRuntime "org.liquibase:liquibase-core"
liquibaseRuntime "org.liquibase.ext:liquibase-hibernate5:4.6.1"
liquibaseRuntime sourceSets.main.compileClasspath
implementation "org.springframework.boot:spring-boot-starter-data-jpa"
// ...

1. 修正Hibernate方言配置 #

通用的HibernateGenericDialect可能无法正确解析实体类映射，建议换成对应数据库的具体方言。比如MySQL用org.hibernate.dialect.MySQL8Dialect，PostgreSQL用org.hibernate.dialect.PostgreSQLDialect，修改后的URL示例：

--url=hibernate:spring:com.company.project.domain?dialect=org.hibernate.dialect.PostgreSQLDialect

2. 先编译实体类再生成变更集 #

Liquibase需要读取编译后的字节码而非源码，执行生成任务前先编译项目：

./gradlew compileJava

之后再运行liquibaseGenerateChangelog。

3. 匹配Liquibase核心与Hibernate扩展版本 #

检查项目中liquibase-core的实际版本，确保它和liquibase-hibernate5（当前是4.6.1）版本兼容，最好保持版本一致。比如如果liquibase-core是4.1.x，就把liquibase-hibernate5也换成4.1.x系列。

4. 补充Spring JPA命名策略参数 #

在URL里添加命名策略参数，确保Liquibase能识别Spring JPA的命名规则：

--url=hibernate:spring:com.company.project.domain?dialect=org.hibernate.dialect.PostgreSQLDialect&hibernate.physical_naming_strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy&hibernate.implicit_naming_strategy=org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy

5. 优化Gradle Liquibase插件配置 #

在build.gradle里直接配置Liquibase参数，避免命令行参数遗漏：

plugins {
    id 'org.liquibase.gradle' version '2.2.0'
}

liquibase {
    activities {
        main {
            changeLogFile 'src/main/resources/config/liquibase/master.xml'
            url 'hibernate:spring:com.company.project.domain?dialect=org.hibernate.dialect.PostgreSQLDialect'
            driver 'liquibase.ext.hibernate.database.connection.HibernateDriver'
            classpath sourceSets.main.compileClasspath
        }
    }
}

之后直接执行./gradlew liquibaseGenerateChangelog即可。

6. 检查实体类JPA注解合法性 #

确认实体类上的@Entity、@Table等注解无错误，比如@Table的name属性是否合法，主键生成策略是否符合目标数据库要求。

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