Liquibase 不创建基于 JPA 实体的差异变更日志答案

【问题标题】：Liquibase not creating diff changelog based on JPA EntitiesLiquibase 不创建基于 JPA 实体的差异变更日志
【发布时间】：2019-02-20 20:21:08
【问题描述】：

我试图在已经提出的问题以及一些用户推荐的帖子中找到答案：http://www.operatornew.com/2012/11/automatic-db-migration-for-java-web.html，但没有任何运气。

问题是我使用 Maven 构建工具和 Postgres DB 为我的 Java 项目配置了完整的 Liquibase，但即使我定义了 Hibernate 实体，Liquibase diff 也没有考虑到它们并且不会产生基于 JPA 注释实体的变更锁。

我尝试了所有方法，但使用空 changelock-master.xml 并定义了 2 个实体，结果 diff.xml 为空。

这是我的 pom.xml：

        <!--LIQUIBASE-->
        <dependency>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-core</artifactId>
        </dependency>
        <dependency>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <version>3.4.1</version>
        </dependency>
        ...
        <plugin>
                <groupId>org.liquibase</groupId>
                <artifactId>liquibase-maven-plugin</artifactId>
                <version>3.5.3</version>
                <dependencies>
                    <dependency>
                        <groupId>org.liquibase.ext</groupId>
                        <artifactId>liquibase-hibernate4</artifactId>
                        <version>3.6</version>
                    </dependency>
                    <dependency>
                        <groupId>org.springframework</groupId>
                        <artifactId>spring-beans</artifactId>
                        <version>4.1.7.RELEASE</version>
                    </dependency>
                    <dependency>
                        <groupId>org.springframework.data</groupId>
                        <artifactId>spring-data-jpa</artifactId>
                        <version>1.7.3.RELEASE</version>
                    </dependency>
                </dependencies>
                <configuration>
                    <propertyFile>src/main/resources/liquibase.properties</propertyFile>
                    <changeLogFile>src/main/resources/db/changelog/changelog-master.xml</changeLogFile>
                </configuration>
            </plugin>

在这里我定义了我的 liquibase.properties：

referenceUrl=hibernate:spring:com.victus.applied.entity?dialect=org.hibernate.dialect.PostgreSQLDialect
referenceDriver=liquibase.ext.hibernate.database.connection.HibernateDriver
referenceUsername=testusername
referencePassword=
driver=org.postgresql.Driver
url=jdbc:postgresql://localhost:5432/applied
username=testusername
password=
changeLogFile=src/main/resources/db/changelog/changelog-master.xml
diffChangeLogFile=src/main/resources/liquibase-diff.xml
outputChangeLogFile=src/main/resources/db/changelog/changelog-master.xml

在我的 application.properties 我也有：

##Liquibase
spring.liquibase.change-log=classpath:/db/changelog/changelog-master.xml
logging.level.liquibase = INFO

##Postgres DB
spring.datasource.url= jdbc:postgresql://localhost:5432/applied
spring.datasource.driver-class-name=org.postgresql.Driver
spring.datasource.username=wiktordyngosz
spring.datasource.password=

# The SQL dialect makes Hibernate generate better SQL for the chosen database
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.properties.hibernate.temp.use_jdbc_metadata_defaults = false

# Hibernate ddl auto (create, create-drop, validate, update)
spring.jpa.hibernate.ddl-auto=create
spring.jpa.show-sql=true
spring.messages.basename=validation

我定义了简单的两个实体，例如其中一个：

@Entity
@Table(name = "user")
@Getter
@Setter
@NoArgsConstructor
@EqualsAndHashCode
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    @NotNull
    private String username;

    @NotNull
    private String password;

    @Transient
    private String passwordConfirm;

    @ManyToMany
    @JoinTable(name = "user_role", joinColumns = @JoinColumn(name = "user_id"), inverseJoinColumns = @JoinColumn(name = "role_id"))
    private Set<Role> roles;
}

当我有一个空的 changelock-master.xml 文件并调用 mvn liquibase:diff 以根据我的实体生成更改锁时，生成的更改锁是空的。日志如下所示：

[INFO] ------------------------------------------------------------------------
[INFO] Parsing Liquibase Properties File
[INFO]   File: src/main/resources/liquibase.properties
[INFO]   'outputChangeLogFile' in properties file is not being used by this task.
[INFO] ------------------------------------------------------------------------
[INFO] Executing on Database: jdbc:postgresql://localhost:5432/applied
INFO 20.02.19 21:19: liquibase-hibernate: Reading hibernate configuration hibernate:spring:com.victus.applied.entity?dialect=org.hibernate.dialect.PostgreSQLDialect
INFO 20.02.19 21:19: liquibase-hibernate: Found package com.victus.applied.entity
INFO 20.02.19 21:19: liquibase-hibernate: Found dialect org.hibernate.dialect.PostgreSQLDialect
INFO 20.02.19 21:19: liquibase-hibernate: Found hibernate.enhanced_idfalse
lut 20, 2019 9:19:26 PM org.hibernate.jpa.internal.util.LogHelper logPersistenceUnitInformation
INFO: HHH000204: Processing PersistenceUnitInfo [
    name: default
    ...]
lut 20, 2019 9:19:26 PM org.hibernate.Version logVersion
INFO: HHH000412: Hibernate Core {4.3.11.Final}
lut 20, 2019 9:19:26 PM org.hibernate.cfg.Environment <clinit>
INFO: HHH000206: hibernate.properties not found
lut 20, 2019 9:19:26 PM org.hibernate.cfg.Environment buildBytecodeProvider
INFO: HHH000021: Bytecode provider name : javassist
lut 20, 2019 9:19:27 PM org.hibernate.annotations.common.reflection.java.JavaReflectionManager <clinit>
INFO: HCANN000001: Hibernate Commons Annotations {4.0.5.Final}
lut 20, 2019 9:19:27 PM org.hibernate.dialect.Dialect <init>
INFO: HHH000400: Using dialect: org.hibernate.dialect.PostgreSQLDialect
INFO 20.02.19 21:19: liquibase-hibernate: Using dialect org.hibernate.dialect.PostgreSQLDialect
[INFO] Performing Diff on database wiktordyngosz @ jdbc:postgresql://localhost:5432/applied (Default Schema: public)
INFO 20.02.19 21:19: liquibase: src/main/resources/liquibase-diff.xml exists, appending
[INFO] Differences written to Change Log File, src/main/resources/liquibase-diff.xml
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

【问题讨论】：

对实际问题没有多大帮助，但为了将来的可搜索性，Liquibase 将包含所有迁移的文件称为变更日志，而不是变更锁。
@UOMan 根据liquibase.properties 判断，您尝试通过比较数据库（postgres）中的模式和您的实际 jpa 实体来生成更改日志。你确定数据库中的模式是空的吗？因为，如果 postgres 中已经定义了 schema，那么生成的 diff 为空是合乎逻辑的。
在这种情况下，您应该将 liquibase 插件设置为详细模式以获取更多信息：<configuration><verbose>true</verbose></configuration>

标签： java hibernate jpa liquibase

【解决方案1】：

根本原因可能是 Liquibase 插件在类路径中找不到您编译的类。

我发现您通过src/main/resources/... 引用您的日志文件很可疑。当作为 Maven 构建的一部分执行 Liquibase 插件时，所有资源都应该直接在类路径上可用，例如changelog-master.xml（没有相对路径）。

尝试在编译后执行 diff 目标作为 Maven 构建的一部分。此 POM 配置将插件绑定到 process-classes phase:

<build>
<plugins>
  <plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>3.6.3</version>
    <dependencies>
...
    </dependencies>
    <configuration>
      <verbose>true</verbose>
    </configuration>
    <executions>
      <execution>
        <goals>
          <goal>diff</goal>
        </goals>
        <phase>process-classes</phase>
      </execution>
    </executions>
  </plugin>

要执行此操作，请运行 mvn process-classes 或稍后的阶段，如 mvn test。

【讨论】：