Liquibase+Hibernate每次diff均删加外键约束，求解决方案

问题场景 #

在Spring Boot应用中使用Liquibase Maven插件，项目包含多个实体类：

• 数据库为空时执行mvn liquibase:diff，可生成对应初始数据库结构的正确changelog；
• 应用启动后Liquibase执行该changelog，能成功创建所有表、约束和序列；
• 但数据库创建完成后再次执行mvn liquibase:diff，预期应生成空的changelog，却每次都会生成如下变更集：

- changeSet:
    id: 1709542912189-1
    author: MarcelloVestri (generated)
    changes:
    - dropForeignKeyConstraint:
        baseTableName: patient
        constraintName: FK_PAT_DOC
- changeSet:
    id: 1709542912189-2
    author: MarcelloVestri (generated)
    changes:
    - addForeignKeyConstraint:
        baseColumnNames: PAT_DOC_ID
        baseTableName: patient
        constraintName: FK_PAT_DOC
        referencedColumnNames: DOC_ID
        referencedTableName: doctor

原因与解决方案 #

该问题源于Hibernate生成的元数据中外键名称与数据库实际存在的外键名称存在细微差异（如大小写、命名规则），导致Liquibase diff功能误判为需要删除重建外键。可通过以下Hibernate配置解决：

1. 使用标准物理命名策略 #

在application.properties中添加：

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

或在application.yml中配置：

spring:
  jpa:
    hibernate:
      naming:
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

此配置会让Hibernate生成的外键名称与数据库中实际创建的完全一致，避免Liquibase的误判。

2. 统一隐式命名策略（可选） #

若上述配置未生效，可补充配置隐式命名策略：

spring.jpa.hibernate.naming.implicit-strategy=org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl

3. 显式指定实体类外键名称 #

在实体类的外键注解中显式指定外键名称，确保与数据库中实际名称完全匹配（注意大小写敏感的数据库需严格一致）：

@ManyToOne
@JoinColumn(
    name = "PAT_DOC_ID", 
    foreignKey = @ForeignKey(name = "FK_PAT_DOC")
)
private Doctor doctor;

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