1. Liquibase 概述

1.1 Liquibase 是什么

Liquibase 是一个开源、与数据库无关的数据库变更管理工具。它通过声明式变更集（ChangeSet）和版本化变更日志（ChangeLog），将数据库 Schema 的每一次修改记录为可追踪、可回滚、可协作的“代码资产”。

核心工作模式：开发者编写数据库变更描述（XML / YAML / JSON / SQL），Liquibase 自动将其转换为目标数据库的 DDL/DML，并维护一张 DATABASECHANGELOG 表来记录哪些变更已执行、哪些尚未执行。

1.2 核心价值

1.3 与传统 SQL 迁移的对比

1.4 适用场景

• 微服务架构：每个服务独立数据库，Liquibase 作为服务启动时的 Schema 初始化组件
• 持续交付流水线：数据库变更与应用代码一同构建、测试、部署
• 多环境管理：开发 → 测试 → 预发 → 生产，确保 Schema 版本一致
• 数据库即代码（Database as Code）：将 DDL 纳入 Git 仓库，支持 Code Review
• 跨数据库迁移：从 MySQL 迁移到 PostgreSQL 或 Oracle 时，ChangeLog 可复用
• 合规审计：DATABASECHANGELOG 表提供完整的变更审计轨迹

1.5 Liquibase 核心工作流程

1.6 典型 ChangeLog 示例

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.20.xsd">

    <changeSet id="1" author="zhangsan">
        <createTable tableName="user">
            <column name="id" type="bigint" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="username" type="varchar(50)">
                <constraints nullable="false" unique="true"/>
            </column>
            <column name="email" type="varchar(100)"/>
        </createTable>
        <rollback>
            DROP TABLE IF EXISTS user;
        </rollback>
    </changeSet>

    <changeSet id="2" author="lisi">
        <addColumn tableName="user">
            <column name="phone" type="varchar(20)"/>
        </addColumn>
    </changeSet>
</databaseChangeLog>