Liquibase切换include标签后多环境校验和不一致问题求助

可能的问题原因 #

• 文件排序逻辑差异：<includeAll>的脚本加载顺序完全依赖操作系统的文件系统排序规则，不同环境（比如Windows和Linux）的排序逻辑不一样。比如带数字的脚本文件名（V1__init.sql、V10__add_col.sql），Windows会按字符串排序把V10排在V2前面，而Linux会按自然数字排序把V10放在V9之后。之前其他环境用<includeAll>时的实际执行顺序和本地不一致，导致数据库databasechangelog表中记录的脚本执行顺序、校验和，和现在<include>指定的固定顺序不匹配，触发校验和冲突。
• 脚本内容的环境差异：如果迁移脚本里用了环境变量（比如${db.schema}），不同环境的变量值不同会导致Liquibase实际执行的SQL不一样，校验和自然就不匹配。另外，文件的换行符（Windows的CRLF和Linux的LF）、空格缩进这类格式差异，也会改变脚本的哈希值，引发校验和冲突。
• 历史执行记录异常：其他环境可能存在<includeAll>时期的异常执行情况——比如脚本被重复执行、漏执行，或者有人手动修改过databasechangelog表的记录，导致现有记录的校验和和现在<include>指定的脚本校验和对不上。

排查与解决建议 #

• 核对跨环境的脚本执行顺序
  • 查问题环境的databasechangelog表，看ORDEREXECUTED字段的顺序，和本地环境的执行顺序对比，确认是不是因为<includeAll>的排序差异导致历史顺序和当前<include>指定的顺序不一致。
  • 在问题环境里用ls（Linux）或dir（Windows）命令查看migrations文件夹的文件排序，和本地的排序对比，找出顺序不一样的脚本。
• 校验脚本内容的一致性
  • 用git diff或者文件对比工具，对比本地和问题环境的迁移脚本，检查换行符、空格、注释这些细节是否完全一致。
  • 开启Liquibase的DEBUG日志，打印出实际执行的SQL，对比不同环境的SQL内容，看是不是环境变量替换导致的差异。
• 检查数据库changelog记录
  • 找到问题环境里提示校验和变更的脚本，查databasechangelog表中对应的MD5SUM值，和本地执行后的MD5SUM、以及用liquibase calculateChecksum命令计算的当前脚本校验和对比。
  • 如果确认是执行顺序差异导致的冲突，可以用liquibase clearCheckSums命令清除历史校验和，让Liquibase重新计算；或者谨慎地手动更新databasechangelog表的MD5SUM字段为当前脚本的正确校验和（前提是确保脚本内容没被篡改）。
• 验证Liquibase版本一致性
  • 确认本地和其他环境用的Liquibase版本是不是一样的，不同版本的校验和计算逻辑可能有细微差别，导致相同脚本算出不同的校验和。

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