1.1 Liquibase 是什么
Liquibase 是一款开源、跨平台的数据库变更管理工具，由 Nathan Voxland 于 2006 年创建。它采用 声明式 + 命令式 双模式驱动，将数据库迁移脚本（DDL/DML）抽象为 变更集（ChangeSet），并通过 变更日志（ChangeLog） 文件统一管理。Liquibase 的核心思想是“数据库版本即代码”，让数据库变更像应用代码一样纳入版本控制、审计和回滚。
核心定义： Liquibase = 数据库迁移框架 + 版本控制引擎 + 回滚管理器 + 环境对齐工具。
1.1.1 核心价值
| 价值维度 | 说明 | 典型收益 |
|---|---|---|
| 版本对齐 | 每个变更集有唯一 ID（author:id），支持按标签、上下文、环境选择性执行 | 开发/测试/生产库结构完全一致 |
| 可回滚 | 每个变更集可定义 rollback SQL，支持自动回滚到任意历史版本 | 上线失败秒级恢复，降低风险 |
| 多数据库兼容 | 支持 MySQL、PostgreSQL、Oracle、SQL Server、DB2、MariaDB、H2 等 20+ 数据库 | 同一套变更日志跨库运行，无需重写 |
| CI/CD 集成 | 提供 Maven、Gradle、Spring Boot、Jenkins、GitLab CI 等原生插件 | 数据库变更纳入自动化流水线 |
| 审计与合规 | 自动记录 DATABASECHANGELOG 表，谁、何时、执行了什么变更 | 满足 SOC2/PCI-DSS 审计要求 |
1.1.2 与传统迁移工具对比
| 对比维度 | Liquibase | Flyway | 手动 SQL 脚本 |
|---|---|---|---|
| 变更描述方式 | XML / YAML / JSON / SQL 混合 | 纯 SQL | 纯 SQL |
| 回滚支持 | 原生内置，每个变更集可定义 rollback | 需手动编写撤销脚本 | 无，需自行维护 |
| 条件执行 | 支持 context / label / precondition | 仅通过版本号顺序 | 无 |
| 多环境对齐 | diffChangelog / diff 命令自动比对 | 需第三方工具辅助 | 人工比对，易出错 |
| CI/CD 原生集成 | Maven/Gradle/Spring Boot/Jenkins 官方插件 | Maven/Gradle/Spring Boot 官方插件 | 需自行封装脚本 |
| 数据库锁机制 | 支持分布式锁（DATABASECHANGELOGLOCK） | 支持锁表 | 无 |
选型建议： 如果团队需要精细化的条件执行、多环境差异比对、以及声明式变更描述，Liquibase 是更优选择；如果团队偏好纯 SQL 且变更流程简单，Flyway 也可胜任。
1.1.3 适用场景
- 微服务架构： 每个服务独立数据库，Liquibase 通过 ChangeLog 隔离变更，避免相互影响。
- 多环境部署： 开发、测试、预发、生产环境数据库结构需严格一致，Liquibase 的 diff 和 sync 命令可自动对齐。
- CI/CD 流水线： 数据库变更作为流水线的一环，与应用代码一起构建、测试、部署。
- 合规审计： 金融、医疗等受监管行业，需要记录每次数据库变更的完整历史。
- 数据库版本回滚： 上线后发现变更导致性能问题或数据损坏，可快速回滚到上一个稳定版本。
- 团队协作： 多人同时开发数据库变更，Liquibase 通过 ChangeSet ID 避免冲突，支持并行开发。
1.1.4 典型工作流
- 定义变更： 在 ChangeLog 文件中编写 ChangeSet（支持 XML/YAML/JSON/SQL 格式）。
- 本地验证： 使用
liquibase updateSQL预览即将执行的 SQL，确保无误。 - 提交代码： 将 ChangeLog 文件提交到 Git，触发 CI 流水线。
- 自动执行： CI 调用
liquibase update自动应用到目标数据库。 - 版本记录： 每次执行后，DATABASECHANGELOG 表记录变更集哈希、执行时间、部署者。
- 回滚（如需）： 执行
liquibase rollbackCount 1回滚最近一次变更。
常见误区： 不要在生产环境直接修改 DATABASECHANGELOG 表记录，这会导致版本状态不一致，引发迁移失败。始终通过 Liquibase 命令管理变更历史。
1.1.5 生态与扩展
- Liquibase Pro： 提供高级回滚、策略管理、RBAC 权限控制等企业级功能。
- Liquibase Hub： 云端监控平台，实时查看迁移状态、性能指标、失败告警。
- 社区插件： 支持自定义 ChangeType、预条件、生成器，可扩展至 MongoDB、Redis 等非关系型数据库。
- IDE 集成： IntelliJ IDEA、VS Code、Eclipse 均有 Liquibase 插件，支持语法高亮、自动补全。