3. Liquibase 安装与配置：Maven/Gradle 集成、Spring Boot 集成、命令行模式

Liquibase 的安装与配置是迁移性能调优的基础。错误的集成方式或配置缺失，往往会导致迁移脚本执行缓慢、数据库连接泄漏甚至 GC 频繁停顿。本章将系统讲解三种主流集成模式：Maven/Gradle 构建工具集成、Spring Boot 自动配置集成以及命令行独立模式，并给出每种模式下的性能敏感配置项。

3.1 集成模式对比与选型

不同的项目阶段和团队技术栈，适合不同的集成方式。下表从性能控制粒度、启动开销、调试便利性三个维度进行对比：

3.2 Maven/Gradle 集成

3.2.1 Maven 插件配置

在 pom.xml 中引入 Liquibase Maven 插件，并指定变更集文件路径、数据源连接信息。以下配置包含性能相关的关键参数：

<build>
  <plugins>
    <plugin>
      <groupId>org.liquibase</groupId>
      <artifactId>liquibase-maven-plugin</artifactId>
      <version>4.25.0</version>
      <configuration>
        <propertyFile>src/main/resources/liquibase.properties</propertyFile>
        <!-- 性能调优：批量提交大小，默认 100，大表迁移建议调至 500-1000 -->
        <changeLogFile>db/changelog/db.changelog-master.xml</changeLogFile>
        <!-- 驱动类名，必须显式指定以避免类加载延迟 -->
        <driver>com.mysql.cj.jdbc.Driver</driver>
        <url>jdbc:mysql://localhost:3306/mydb?rewriteBatchedStatements=true</url>
        <username>${db.username}</username>
        <password>${db.password}</password>
        <!-- 输出 SQL 到日志，便于排查性能瓶颈 -->
        <verbose>true</optimize>
      </configuration>
    </plugin>
  </plugins>
</build>

3.2.2 Gradle 插件配置

Gradle 集成方式与 Maven 类似，但通过 build.gradle 的 DSL 进行声明：

plugins {
    id 'org.liquibase.gradle' version '2.2.0'
}

liquibase {
    activities {
        main {
            changeLogFile 'src/main/resources/db/changelog/db.changelog-master.xml'
            url 'jdbc:mysql://localhost:3306/mydb?rewriteBatchedStatements=true'
            username 'root'
            password 'password'
            driver 'com.mysql.cj.jdbc.Driver'
            // 性能调优：关闭自动提交，由 Liquibase 控制事务边界
            // 减少频繁提交带来的网络往返
        }
    }
}

3.3 Spring Boot 集成

Spring Boot 通过 spring-boot-starter-liquibase 提供零配置集成，但默认行为可能不适合高性能迁移场景。以下配置覆盖了关键性能调优点：

# application.yml
spring:
  liquibase:
    enabled: true
    change-log: classpath:db/changelog/db.changelog-master.xml
    # 性能调优：关闭默认的 context 自动扫描，减少启动时的类路径扫描开销
    contexts: production
    # 性能调优：设置默认 schema，避免每次迁移都执行 schema 解析
    default-schema: public
    # 性能调优：批量 SQL 执行大小，默认 100，大表迁移建议调至 1000
    # 注意：过大的 batchSize 可能导致单次事务过大，增加 GC 压力
    batch-size: 500
    # 性能调优：关闭 drop-first，避免生产环境误操作
    drop-first: false
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?rewriteBatchedStatements=true&cachePrepStmts=true
    hikari:
      maximum-pool-size: 5
      minimum-idle: 2

3.4 命令行模式

命令行模式将 Liquibase 作为独立 JVM 进程运行，是性能调优最灵活的方式。它允许你为迁移进程单独设置堆大小、GC 算法和日志级别，完全隔离业务应用的 JVM 参数。

3.4.1 安装与基础命令

从 Liquibase 官网下载 ZIP 包后，解压并配置 liquibase.properties：

# liquibase.properties
changeLogFile: db/changelog/db.changelog-master.xml
url: jdbc:mysql://localhost:3306/mydb?rewriteBatchedStatements=true
username: root
password: password
driver: com.mysql.cj.jdbc.Driver
# 性能调优：设置输出编码，避免字符转换开销
outputEncoding: UTF-8
# 性能调优：设置日志级别为 WARNING，减少日志 I/O 对迁移性能的影响
logLevel: WARNING

常用命令示例：

# 更新数据库（带性能参数）
liquibase --defaultsFile=liquibase.properties update \
  --changelogFile=db/changelog/db.changelog-master.xml

# 回滚到指定标签（生产环境紧急回滚）
liquibase --defaultsFile=liquibase.properties rollback \
  --tag=v1.0.0

# 生成 SQL 文件（预检迁移影响）
liquibase --defaultsFile=liquibase.properties updateSQL \
  --outputFile=./migration_preview.sql

3.4.2 JVM 参数调优（命令行模式独有优势）

命令行模式允许你为 Liquibase 进程单独指定 JVM 参数，这是 Maven/Gradle 和 Spring Boot 集成难以做到的：

# 启动脚本示例：liquibase_perf.sh
#!/bin/bash
JAVA_OPTS="-Xms512m -Xmx2g \
  -XX:+UseG1GC \
  -XX:MaxGCPauseMillis=100 \
  -XX:ParallelGCThreads=4 \
  -XX:ConcGCThreads=2 \
  -XX:+PrintGCDetails \
  -XX:+PrintGCDateStamps \
  -Xloggc:./gc-liquibase-%t.log"

liquibase --defaultsFile=liquibase.properties \
  --java-opts="$JAVA_OPTS" \
  update

3.5 三种集成模式的性能决策流程

以下 SVG 流程图展示了在不同场景下如何选择集成模式，并标注了每个决策点的性能考量：

3.6 配置清单与性能检查表

无论选择哪种集成模式，以下配置项都直接影响迁移性能和 GC 行为。建议在集成完成后逐项核对：