Liquibase在无变更场景下仍生成dropDefaultValue变更集问题求助

你遇到的问题本质是Hibernate实体元数据与数据库实际元数据之间的默认值定义差异，导致Liquibase的diff功能每次运行都识别出“虚假”的变更：

1. 对于oneMoreField2和oneMoreField3：这两个字段没有显式添加@Column注解，Hibernate会默认生成nullable=true但无显式默认值的列定义；但数据库中，未指定默认值的列默认行为是DEFAULT NULL，Liquibase对比时会认为数据库中的列有默认值null，而Hibernate元数据中没有，所以生成dropDefaultValue变更。
2. 对于password字段：你显式指定了columnDefinition = "varchar(15) default null"，但第一次生成的变更集中没有包含这个默认值（因为DEFAULT NULL是数据库的默认行为，Liquibase首次生成时会忽略）；第二次对比时，Hibernate元数据携带了这个显式的default null定义，而数据库中该列的默认值是隐式的null，Liquibase会认为需要添加显式的默认值，从而生成addDefaultValue变更。

下面是几种可行的解决方法，按推荐优先级排序：

1. 统一实体字段的注解配置，避免隐式默认值差异 #

调整实体类定义： #

• 对于不需要显式默认值的字段（如oneMoreField2、oneMoreField3），显式添加@Column注解，明确指定nullable=true（和Hibernate默认行为一致），但不指定columnDefinition或defaultValue；
• 对于password字段，去掉columnDefinition中的default null，因为这是数据库的默认行为，无需显式声明：

@Entity
public class Sample {
    @Id
    long id;

    @Column(name = "username", columnDefinition = "varchar(15) default 'dfds'")
    String username;

    // 去掉default null的显式声明
    @Column(name = "password", columnDefinition = "varchar(15)")
    String password;

    // 显式添加@Column，明确nullable=true，无默认值
    @Column(nullable = true)
    String oneMoreField2;

    @Column(nullable = true)
    String oneMoreField3;
}

这样Hibernate元数据和数据库元数据的默认值定义会保持一致，Liquibase不会再生成不必要的变更。

2. 使用Liquibase的ObjectChangeFilter忽略默认值变更 #

如果你不想修改实体类，可以通过自定义ObjectChangeFilter来过滤掉默认值相关的变更：

ObjectChangeFilter objectChangeFilter = new ObjectChangeFilter() {
    @Override
    public boolean include(Change change, Database referenceDatabase, Database comparisonDatabase) {
        // 过滤掉dropDefaultValue和addDefaultValue类型的变更
        return !(change instanceof DropDefaultValueChange || change instanceof AddDefaultValueChange);
    }
};

// 然后将这个filter传入diffOutputControl
diffOutputControl.setObjectChangeFilter(objectChangeFilter);

这种方法适合临时快速解决，但注意会忽略所有默认值相关的真实变更，需要谨慎使用。

3. 检查Liquibase和hibernate-liquibase的版本兼容性 #

某些版本的liquibase-hibernate在处理默认值元数据时存在bug，建议确保你使用的Liquibase和hibernate-liquibase版本匹配（比如使用最新的稳定版）。例如：

• Liquibase 4.x搭配hibernate-liquibase 4.x版本
• 避免使用过于老旧的版本（如Liquibase 3.x）

4. 确认变更集已正确应用到数据库 #

在生成diff之前，确保你已经调用liquibaseUpdate.update("")将之前的变更集完全应用到数据库，可以检查数据库的databasechangelog表，确认所有变更集都标记为已执行，这样数据库状态和实体元数据完全一致，Liquibase就不会生成重复变更。

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