Liquibase对比不同Hibernate模型包未检测到差异的解决方法

我在build.gradle中配置了Liquibase Gradle插件的diff任务，url相比referenceUrl多包含了rf.dom.billing.model.service包，预期能检测到该包实体对应的表差异，但执行结果显示未发现任何变化。

配置代码如下：

liquibase {
    activities {
        main {
            changeLogFile "$buildDir/generated-migrations.xml"            
            url 'hibernate:spring:rf.dom.billing.model.contractor,rf.dom.billing.model.billing,rf.dom.billing.model.dict,rf.dom.billing.model.meta,rf.dom.billing.model.service?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'
            referenceUrl 'hibernate:spring:rf.dom.billing.model.contractor,rf.dom.billing.model.billing,rf.dom.billing.model.dict,rf.dom.billing.model.meta?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'
            logLevel 'debug' 
        }
        runList = "main"
    }
}

执行日志输出：

02:48:03.323 INFO  [liquibase.diff.output.changelog.DiffToChangeLog$1]: No changes found, nothing to do
02:48:03.324 INFO  [liquibase.integration.commandline.Main]: Liquibase command 'diffChangeLog' was executed successfully.

• 确认实体类注解：检查rf.dom.billing.model.service包下的类是否添加了@Entity、@Table等JPA注解，无注解的类不会被Hibernate识别为数据库实体，Liquibase无法检测到差异。
• 校验包路径拼写：确保包名大小写、分隔符完全正确，避免因拼写错误导致Liquibase扫描不到目标包。
• 调整Liquibase扫描配置：尝试在Hibernate URL参数中添加packagesToScan明确指定扫描包，或者添加hibernate.hbm2ddl.auto=validate强制Hibernate校验实体映射，帮助Liquibase正确识别实体。
• 清理构建缓存：执行./gradlew clean清理Gradle构建缓存，避免使用旧的类文件导致扫描异常。
• 查看完整Debug日志：当前日志仅展示INFO级别，Debug日志会输出扫描到的实体列表、连接详情等信息，通过完整日志确认rf.dom.billing.model.service下的实体是否被加载。
• 调换对比方向验证：临时交换url和referenceUrl的配置，重新执行diff任务。如果此时能检测到差异，说明需要确认Liquibase diff的对比方向是否符合预期。

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