Liquibase校验和变更致验证失败：非生产环境如何处理？

你遇到的是Liquibase的校验和校验机制触发的报错——因为修改了已经执行过的changeset（ID为kh:1），Liquibase会对比数据库changelog表中存储的旧校验和与当前脚本的新校验和，不一致则触发安全拦截。生产环境这是必要的防护，但非生产环境可根据场景灵活处理，以下是具体方案及最佳实践：

可选解决方案 #

1. 重置校验和（推荐轻量方案） #

使用clearCheckSums命令清空数据库中存储的对应changeset校验和，下次执行update时Liquibase会重新计算并存储新校验和，无需恢复数据库或调整脚本结构，适合反复调试同一changeset的场景。

对应Docker命令：

docker run --rm -v /changelog:/liquibase/changelog liquibase/liquibase \
--url=jdbc:postgresql://xxxxxxxxxx:5432/postgres \
--changelog-file=changelog.sql --username=xxxx \
--password=xxxx clearCheckSums

执行完该命令后，再运行原update命令即可正常执行修改后的脚本。

2. 临时跳过校验和验证 #

在update命令中添加--validate=false参数，直接跳过校验和校验，强制执行脚本。适合单次紧急调试，但不建议长期使用，可能掩盖脚本本身的问题。

命令示例：

docker run --rm -v /changelog:/liquibase/changelog liquibase/liquibase \
--url=jdbc:postgresql://xxxxxxxxxx:5432/postgres \
--changelog-file=changelog.sql --username=xxxx \
--password=xxxx --validate=false update

3. 恢复/回滚数据库后重新执行 #

如果需要完全重置环境，可通过数据库备份恢复到修改前的状态，或使用Liquibase的回滚命令撤销已执行的changeset，再执行修改后的脚本。

比如回滚最近1个changeset的命令：

docker run --rm -v /changelog:/liquibase/changelog liquibase/liquibase \
--url=jdbc:postgresql://xxxxxxxxxx:5432/postgres \
--changelog-file=changelog.sql --username=xxxx \
--password=xxxx rollback-count 1

该方案适合需要彻底清理环境、从头验证脚本的场景，但操作比重置校验和繁琐。

4. 修改changeset属性或ID #

• 修改ID：将原changeset的ID改为新值（如kh:1.1），Liquibase会将其视为新的changeset执行，无需处理校验和。
• 添加runOnChange: true属性：在changeset上添加该属性，每次脚本内容变化时，Liquibase会自动重新执行此changeset。注意：需确保脚本是幂等的（例如将CREATE TABLE改为CREATE TABLE IF NOT EXISTS），否则会触发重复创建等错误。

示例修改后的脚本：

-- liquibase formatted sql

-- changeset kh:1 runOnChange:true
CREATE TABLE IF NOT EXISTS test_table (test_id INT, test_column VARCHAR(256), test_column2 VARCHAR(256), PRIMARY KEY (test_id))

--changeset kh:2
INSERT INTO test_table (test_id, test_column) VALUES(3,'saket');

非生产环境最佳实践 #

• 日常调试优先用重置校验和（clearCheckSums）：操作简单高效，不破坏现有环境，适配反复修改同一脚本的场景。
• 脚本趋于稳定后，可使用**runOnChange: true**（配合幂等脚本）：后续微调时无需手动重置校验和，Liquibase会自动处理。
• 跳过校验和（--validate=false）仅作为临时应急方案，避免长期依赖。
• 你提到的“新增changeset实现变更”方案确实不合理：会导致changelog冗余，调试完成后还需清理，降低效率。

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