Liquibase变更集依赖关系的冒烟验证与故障排查 - 第1节
1.1 Liquibase 是什么
Liquibase 是一款开源、数据库无关的数据库变更管理工具。它通过声明式或 SQL 脚本描述数据库结构变更（Schema Change），并将这些变更存储在可版本控制的文件中，从而让数据库的演进过程像应用代码一样可追溯、可回滚、可协作。
与直接使用 SQL 脚本或 GUI 工具手动修改数据库不同，Liquibase 将每一次变更视为一个“变更集”（ChangeSet），并记录哪些变更已经在目标数据库上执行过，避免重复执行或遗漏执行。
核心定位：Liquibase 是数据库的“Git + Maven/Gradle”——它提供版本控制能力，同时管理变更的依赖与执行顺序。
1.2 核心概念
1.2.1 ChangeLog（变更日志）
ChangeLog 是 Liquibase 的入口文件，通常命名为 db.changelog-master.xml 或 changelog.yaml。它按顺序组织所有变更集，并可以引用其他子 ChangeLog 文件，形成层级结构。
| 属性 | 说明 | 示例值 |
|---|---|---|
logicalFilePath |
逻辑路径，用于跨环境识别同一 ChangeLog | com/example/db/changelog.xml |
context |
运行上下文过滤（如 dev、prod） | dev,test |
objectQuotingStrategy |
数据库对象引用策略 | QUOTE_ONLY_RESERVED_WORDS |
1.2.2 ChangeSet（变更集）
ChangeSet 是 Liquibase 的最小变更单元。每个 ChangeSet 包含一个或多个变更操作（如创建表、添加列、插入数据），并且必须具有全局唯一的 id + author 组合标识。
<changeSet id="create-user-table" author="devops_team">
<createTable tableName="users">
<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>
最佳实践：每个 ChangeSet 只做一件事（单一职责），例如只创建一张表，或只添加一个索引。这有助于依赖关系清晰、回滚粒度精确。
1.2.3 核心概念关系图
1.3 数据库版本控制的价值
传统数据库变更管理存在以下痛点：
- 变更不可追溯：谁在什么时间改了什么，没有统一记录。
- 环境不一致：开发、测试、生产数据库结构经常出现差异。
- 回滚困难：一旦执行错误变更，需要手动逆向操作，风险极高。
- 协作冲突：多人同时修改数据库结构，缺乏合并与冲突检测机制。
Liquibase 通过数据库版本控制解决了上述问题，其核心价值体现在：
| 价值维度 | 具体表现 | 业务收益 |
|---|---|---|
| 可追溯性 | 每个 ChangeSet 记录 author、id、时间戳、文件路径 | 快速定位问题变更的责任人与时间点 |
| 环境一致性 | 同一 ChangeLog 在不同环境执行相同变更序列 | 消除“在我机器上能跑”的数据库差异 |
| 可回滚 | 每个 ChangeSet 可定义 rollback 脚本 | 安全回退到任意历史版本 |
| 自动化集成 | 支持 Maven、Gradle、Jenkins、GitLab CI 等 | 数据库变更纳入 CI/CD 流水线 |
| 依赖管理 | 通过 preConditions 和 dependsOn 控制执行顺序 |
避免因变更顺序错误导致的失败 |
常见误区：数据库版本控制 ≠ 数据库备份。版本控制管理的是“结构变更历史”，而备份是“数据快照”。两者应配合使用，不可相互替代。
1.4 数据库版本控制与传统版本控制对比
1.5 本章小结
- Liquibase 是数据库变更管理工具，核心单元为 ChangeLog 和 ChangeSet。
- ChangeLog 组织变更集，ChangeSet 定义具体变更操作，两者配合实现数据库版本控制。
- 数据库版本控制带来可追溯、环境一致、可回滚、自动化集成、依赖管理等核心价值。
- 理解这些基础概念，是后续学习变更集依赖关系与冒烟验证的前提。