PostgreSQL升级至12后Liquibase校验和验证失败且onValidationFail未生效

首先，你遇到的问题很典型——PostgreSQL大版本升级后，Liquibase计算的变更集校验和和数据库DATABASECHANGELOG表中存储的旧值不匹配，而且即使设置了onValidationFail="MARK_RAN"也触发了异常。我来一步步拆解原因和解决方案：

为什么校验和会变化？ #

Liquibase的校验和计算并非只依赖变更集的XML内容，它还会结合数据库版本特定的SQL生成逻辑和元数据读取结果。PostgreSQL 9.6到12的大版本升级中，很多底层细节（比如数据类型的默认处理、约束的存储格式、元数据查询的返回结构）都有细微调整：

• Liquibase在生成执行SQL时，会根据目标数据库版本做适配，不同版本生成的SQL可能存在格式差异（比如空格、关键字大小写、注释等），这些差异会影响校验和的哈希计算。
• 当Liquibase验证已执行的变更集时，会读取数据库元数据和变更集定义对比，PostgreSQL版本升级后元数据的细微变化也会导致校验和不匹配。

简单说，Liquibase的校验和不是完全“数据库无关”的，大版本数据库升级确实可能触发这类问题。

为什么onValidationFail="MARK_RAN"没生效？ #

在Liquibase 3.8.0这个较老的版本中，onValidationFail="MARK_RAN"的生效有个前提：Liquibase需要确认该变更集已经被执行过（即DATABASECHANGELOG表中存在对应记录）。如果数据库升级后，Liquibase对PostgreSQL 12的元数据读取存在兼容性问题，可能导致它无法正确识别变更集的执行状态，从而跳过了MARK_RAN的逻辑，直接抛出校验失败异常。

解决方案 #

1. 批量同步校验和（最快解决当前问题） #

既然你只是升级了数据库，所有变更集都已经正确执行过，最直接的方法是让Liquibase将当前计算的新校验和同步到DATABASECHANGELOG表中：

• 使用Liquibase命令行执行：

  liquibase changelogSync
  

  这个命令会遍历你的变更集，计算当前环境下的校验和，并更新DATABASECHANGELOG表中对应记录的MD5SUM字段。执行后，启动应用就不会再触发校验和不匹配的异常了。
• 如果不想直接修改数据库，可以先执行changelogSyncSQL生成对应的SQL语句，手动确认后再执行：

  liquibase changelogSyncSQL
  

2. 升级Liquibase版本（预防未来问题） #

Liquibase 3.8.0是2019年的版本，对PostgreSQL 12的支持不够完善。升级到4.x系列的稳定版本（比如4.20+），新版本对PostgreSQL各个大版本的兼容性更好，能减少因数据库版本升级导致的校验和差异问题。同时，新版本对onValidationFail的逻辑也做了优化，更符合预期。

3. 长期预防措施 #

• 尽量使用跨数据库兼容的变更集语法：避免依赖PostgreSQL特定的函数、语法或元数据特性，让变更集的SQL生成逻辑更稳定。
• 关闭启动校验（不推荐）：如果实在不想处理校验和问题，可以在Liquibase配置中设置liquibase.validateOnStartup=false，但这会关闭变更集的校验机制，存在变更集被意外修改而无法发现的风险，仅建议在测试环境临时使用。

总结 #

你遇到的问题核心是数据库大版本升级导致Liquibase校验和计算的依据变化，而老版本Liquibase对新PostgreSQL版本的兼容性不足。通过changelogSync同步校验和能快速解决当前问题，升级Liquibase版本则能从根源减少未来出现类似问题的概率。

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