多服务共享数据库表时Liquibase初始化YAML存放位置及启动报错咨询

一、共用表的Liquibase初始化YAML存放位置 #

针对多个服务共用同一张数据库表（如user表）的场景，推荐两种标准方案：

• 抽离为共享依赖模块：将共用的数据库变更集YAML文件放到独立的Maven/Gradle模块中，让两个业务服务都依赖这个模块。这样变更集只需要维护一份，既避免重复配置，也能保证所有服务使用的表结构定义完全一致。
• 集中式变更管理服务：搭建一个专门负责数据库变更的独立服务，统一执行所有共用表的初始化和后续结构变更操作。业务服务仅负责数据读写，不配置任何Liquibase变更集，从根源上消除重复配置的可能。

二、重复配置导致liquibase.exception.ValidationFailedException的原因及解决 #

报错原因 #

当第二个服务启动时，Liquibase会对比本地变更集与databasechangelog表中已执行的记录：

1. 若变更集的ID、作者或内容（哪怕是空格、注释的细微差异）与已执行记录不匹配，Liquibase会判定校验失败；
2. 即使变更内容完全一致，部分场景下Liquibase也会因为检测到重复的变更集定义触发校验报错。

解决办法 #

1. 移除重复配置（优先方案）：立即将共用的变更集迁移到共享模块或集中变更服务，确保所有服务使用同一来源的变更定义。
2. 修复数据库变更记录：
   • 先备份数据库，然后手动检查databasechangelog表，删除因重复配置产生的冗余记录；
   • 执行Liquibase命令liquibase clearCheckSums清除已记录的校验和，让Liquibase重新校验变更集与现有表结构的一致性。
3. 临时跳过校验（不推荐）：在第二个服务的application.yml中添加配置：

   liquibase:
     validation-mode: none
   

   该配置会关闭Liquibase的校验机制，仅适合临时应急使用，长期使用可能隐藏表结构不一致的风险。

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