多微服务共享数据库迁移PostgreSQL遇Liquibase校验和异常的解决方案

问题根源 #

多个微服务共用同一个PostgreSQL数据库时，各自的Liquibase变更脚本都会写入同一个DATABASECHANGELOG表。当某微服务启动时，Liquibase会对比本地changelog文件和表中记录的校验和，要是其他微服务已经执行过不属于当前服务的变更，就会触发校验和不匹配的报错。

可行解决方案 #

1. 给每个微服务配独立数据库（最推荐） #

完全贴合微服务自治的设计思路：

• 每个微服务单独用一个PostgreSQL数据库，各自维护自己的DATABASECHANGELOG表，变更操作彻底隔离
• 彻底避免跨服务的变更冲突，后续维护、扩容都更清晰
• 微服务间需要数据交互的话，用API调用或消息队列，别直接碰其他服务的数据库

2. 为每个微服务创建独立Schema #

如果没法拆分数据库，这是次优选择：

• 先在PostgreSQL里给每个微服务建专属Schema，比如执行命令：CREATE SCHEMA service_a_schema;
• 在Spring Boot的配置文件里指定Liquibase默认使用的Schema：

  spring.liquibase.default-schema=service_a_schema
  

• 每个微服务的Liquibase脚本只操作自己的Schema，DATABASECHANGELOG表也会存在对应Schema下，相互之间不会干扰

3. 统一管理变更脚本，取消微服务自动执行 #

如果必须共享数据库且不能拆分Schema，就把所有变更脚本集中管理：

• 把各个微服务的Liquibase脚本统一放到单独的仓库或变更管理服务里，不再让微服务自己带脚本
• 每个微服务启动时关掉Liquibase自动执行：

  spring.liquibase.enabled=false
  

• 然后通过CI/CD管道或者专门的变更流程统一执行数据库脚本，这种方式要严格控版本和审批，避免脚本冲突

4. 临时跳过校验和检查（仅应急用） #

如果只是要先让服务启动，可临时禁用校验，但有数据风险：

• 在配置里加一行：

  spring.liquibase.validate-on-migrate=false
  

• 注意：这么做会关掉Liquibase的校验逻辑，可能导致脚本变更和数据库状态不匹配，只能在测试环境或紧急场景用，别长期用

要不要共享数据库表？ #

完全没必要。微服务的核心就是各自独立，共享数据库表会把服务绑死，后续改需求、扩容量都麻烦得要死。除非业务上有强依赖且实在没法用其他方式解耦，否则千万别这么干。

可能漏了的配置检查点 #

• 核对每个微服务的spring.liquibase.change-log配置，确保指向的是自己的脚本，不是别的服务的
• 检查PostgreSQL的用户权限，每个微服务的数据库用户最好只拥有自己Schema的操作权限，防止误改其他服务的表或DATABASECHANGELOG记录
• 统一Liquibase版本：不同版本的Liquibase计算校验和的逻辑可能不一样，所有微服务要用到相同版本的Liquibase依赖

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