Spring Boot配置Liquibase生成实体与数据库差异文件的问题

问题说明 #

执行mvn liquibase:generateChangeLog或mvn liquibase:diff命令时，生成的变更日志文件为空，需要生成能体现数据库与实体类差异的日志文件。

现有配置信息 #

application.properties 配置 #

spring.datasource.url= jdbc:postgresql://localhost:5432/db
spring.datasource.username= username
spring.datasource.password= pswd
spring.messages.basename=messages
spring.messages.cache-duration=3600
spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation= true
spring.jpa.properties.hibernate.dialect= org.hibernate.dialect.PostgreSQLDialect
spring.jpa.hibernate.ddl-auto=validate

Liquibase 配置 #

spring.liquibase.enabled=true
spring.liquibase.change-log=classpath:db/changelog/db.changelog.yml

pom.xml 依赖及插件配置 #

<dependency>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-core</artifactId>
    <version>4.25.0</version>
</dependency>
<dependency>
    <groupId>org.liquibase.ext</groupId>
    <artifactId>liquibase-hibernate6</artifactId>
    <version>4.25.0</version>
</dependency>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <version>4.25.0</version>
            <configuration>
                <propertyFile>src/main/resources/db/changelog/liquibase.properties</propertyFile>
                <!--                    <verbose>true</verbose>-->
                <outputChangeLogFile>src/main/resources/db/changelog/db-changelog-master.yml</outputChangeLogFile>
                <!--                    <changeLogFile>src/main/resources/db/changelog/db-changelog-master.yml</changeLogFile>-->
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>generateChangeLog</goal>
                        <goal>update</goal>
                        <goal>diff</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

实体类 TestUser #

@Entity
@Getter
@Setter
@Table(name = "test_user")
public class TestUser {
    @Id
    @Column(name = "id")
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Column(name = "username")
    private String userName;
    @Column(name = "first_name")
    private String firstName;
    @Column(name = "last_name")
    private String lastName;
    @Column(name = "email")
    private String email;
}

解决思路 #

• 补全liquibase.properties配置：你指定了该属性文件但未提供内容，它需要包含Hibernate实体扫描配置才能识别实体类，示例配置如下：

  driver=org.postgresql.Driver
  url=jdbc:postgresql://localhost:5432/db
  username=username
  password=pswd
  # 替换为你的实体类所在包路径
  referenceUrl=hibernate:spring:com.your.package.entity?dialect=org.hibernate.dialect.PostgreSQLDialect
  

• 确保实体类被扫描：在Spring Boot启动类上添加@EntityScan(basePackages = "com.your.package.entity")，明确指定实体类所在包，避免Liquibase无法加载实体。

• 拆分插件执行目标：当前插件执行节点同时绑定了generateChangeLog、update、diff三个目标，可能导致逻辑冲突。建议单独执行目标命令，比如直接运行mvn liquibase:diff而非依赖绑定的执行流程。

• 验证数据库与实体的差异：如果数据库中test_user表的结构和实体类完全一致，生成的变更日志自然为空。可以手动删除表或修改实体类字段后再执行命令测试。

• 启用详细日志排查：打开插件配置中的<verbose>true</verbose>，执行命令时查看日志输出，定位是否存在实体加载失败、数据库连接异常或差异识别逻辑错误的具体问题。

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