runInTransaction设为false时Liquibase DATABASECHANGELOG何时无效？

为什么你的测试案例中DATABASECHANGELOG状态正常？ #

你的变更集做了两个关键操作：

• 手动用BEGIN;和COMMIT;包裹所有语句，把整个变更集变成了数据库层面的原子事务
• 设置splitStatements:false，让Liquibase不会拆分SQL，而是把整个块当作单一语句执行

这种情况下，即便runInTransaction:false，实际事务控制权在数据库手里。当中间的INSERT NULL触发错误时，数据库会直接回滚整个事务（包括之前的CREATE TABLE和第一条INSERT），而Liquibase只有在整个语句执行成功后，才会往DATABASECHANGELOG里写入变更集记录。失败时没有写入，所以表状态完全正常，修复后可重新执行。

真正会导致DATABASECHANGELOG无效的场景 #

当满足以下条件时，才会触发文档中警告的无效状态：

1. runInTransaction:false（Liquibase不开启全局事务包裹变更集）
2. 变更集被拆分为多个独立执行的语句（比如splitStatements:true，或未手动用事务包裹多条语句）
3. 前序语句执行成功，后续语句执行失败

举个典型例子：

--liquibase formatted sql
--changeset test:bad_case runOnChange:false splitStatements:true runInTransaction:false
CREATE TABLE IF NOT EXISTS test (
    id serial PRIMARY KEY,
    name text NOT NULL
);

INSERT INTO test (name) VALUES ('test1');
INSERT INTO test (name) VALUES (NULL); -- 违反NOT NULL约束，执行失败
INSERT INTO test (name) VALUES ('test2');

这个场景下：

• Liquibase会拆分出4条独立语句依次执行
• 前两条（CREATE TABLE、第一条INSERT）执行成功，此时Liquibase会将这条变更集标记为「已执行」，写入DATABASECHANGELOG
• 第三条INSERT失败，Liquibase终止执行，但已写入的DATABASECHANGELOG记录不会回滚
• 结果就是：DATABASECHANGELOG显示变更集已完成，但实际数据库中test表只有一条数据，后续INSERT未执行。下次迁移时Liquibase会跳过这条变更集，导致数据永远不一致——这就是文档所说的「DATABASECHANGELOG处于无效状态」。

该警告的参考性 #

这个警告完全具有参考性，但要注意适用边界：它针对的是「Liquibase拆分多条语句、且无全局事务包裹」的场景。如果你像测试案例那样，手动用事务包裹所有语句并关闭拆分，就规避了风险。但在未自行管理事务的多语句变更集中，runInTransaction:false依然是高危设置，必须谨慎使用。

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