2. Liquibase 核心概念：ChangeLog、ChangeSet、DatabaseChangeLog 表、MD5Sum 校验机制

在深入回滚与并发迁移的 GC 停顿控制之前，必须牢固掌握 Liquibase 的四个核心概念。它们是整个迁移框架的基石，直接决定了变更的声明方式、执行顺序、状态追踪与完整性校验。本章将逐一拆解 ChangeLog、ChangeSet、DatabaseChangeLog 追踪表以及 MD5Sum 校验机制，并揭示它们如何协同工作。

2.1 ChangeLog：变更的编排清单

ChangeLog 是 Liquibase 迁移的入口文件，通常为 XML、YAML、JSON 或 SQL 格式。它定义了一组有序的数据库变更（ChangeSet），并控制这些变更的执行逻辑。

• 根元素：<databaseChangeLog> 是所有 ChangeLog 文件的根节点。
• 包含关系：支持通过 <include> 或 <includeAll> 引入子文件，实现模块化编排。
• 上下文与标签：通过 context 和 labels 属性控制变更的生效环境（如 dev、prod）。
• 逻辑控制：支持 preConditions、property 等高级编排能力。

2.2 ChangeSet：原子变更单元

ChangeSet 是 ChangeLog 中的最小执行单元，代表一个不可分割的数据库变更。每个 ChangeSet 必须包含 id、author 和 filePath 三个属性，三者组合形成全局唯一标识。

<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog">
    <changeSet id="create-user-table" author="zhang-san">
        <createTable tableName="user">
            <column name="id" type="bigint" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="username" type="varchar(50)">
                <constraints unique="true" nullable="false"/>
            </column>
            <column name="created_at" type="timestamp" defaultValueComputed="now()"/>
        </createTable>
    </changeSet>
</databaseChangeLog>

2.3 DatabaseChangeLog 表：状态追踪的基石

Liquibase 在目标数据库中维护两张核心追踪表：DATABASECHANGELOG 和 DATABASECHANGELOGLOCK。它们记录了所有已执行变更的元数据，是回滚与并发控制的基础。

DATABASECHANGELOG 表结构

DATABASECHANGELOGLOCK 表：用于分布式环境下的并发锁控制，防止多个 Liquibase 实例同时修改数据库结构。

2.4 MD5Sum 校验机制：变更完整性守护

MD5Sum 是 Liquibase 用于检测 ChangeSet 是否被篡改或意外修改的核心机制。每次执行 ChangeSet 时，Liquibase 会计算其内容的 MD5 哈希值，并存入 DATABASECHANGELOG.MD5SUM 字段。

校验流程

1. 计算：对 ChangeSet 的 XML/YAML/JSON 内容（包括所有子元素和属性）计算 MD5 值。
2. 比对：将计算值与数据库中已存储的 MD5SUM 进行比对。
3. 决策：
   • 匹配 → 跳过该 ChangeSet（已执行且未变更）。
   • 不匹配 → 抛出 ValidationFailedException，阻止迁移继续。
   • 数据库无记录 → 执行该 ChangeSet。

MD5Sum 的生成规则

• 仅对 ChangeSet 的 变更定义部分 计算，不包括 runAlways、runOnChange 等执行控制属性。
• 对于 <sql> 或 <sqlFile> 类型的 ChangeSet，MD5 基于 SQL 文本内容计算。
• 版本升级时，Liquibase 会自动处理 MD5 格式的兼容性（如从 3.x 到 4.x 的哈希算法调整）。

2.5 核心概念关系图

下图展示了 ChangeLog、ChangeSet、DatabaseChangeLog 表与 MD5Sum 之间的协作关系：

2.6 核心概念对比总结

2.7 常见误区与避坑指南