3. Flyway 安装与配置：命令行工具、Maven/Gradle 插件、Spring Boot 集成配置

Flyway 的安装与配置是数据库迁移工作的起点。根据团队技术栈和部署环境的不同，Flyway 提供了三种主流集成方式：命令行工具（适合 CI/CD 与运维）、构建工具插件（Maven/Gradle，适合开发与构建阶段）以及 Spring Boot 自动配置（适合微服务与 Java 应用）。本章将逐一讲解每种方式的安装步骤、核心配置项及最佳实践。

3.1 命令行工具安装与配置

Flyway 命令行工具是一个独立的可执行程序，不依赖 Java 开发环境（仅需 JRE），非常适合在 Docker 容器、Jenkins Pipeline 或 Shell 脚本中执行迁移。

3.1.1 下载与安装

• 下载地址：https://flywaydb.org/download（社区版免费）
• 安装步骤：
  1. 下载对应操作系统（Windows/Linux/macOS）的压缩包。
  2. 解压至目标目录，例如 /opt/flyway 或 C:\flyway。
  3. 将 <flyway-home>/bin 添加到系统 PATH 环境变量。
  4. 验证安装：执行 flyway -v，应输出版本号。

3.1.2 核心配置文件：flyway.conf

命令行工具通过 conf/flyway.conf 文件配置数据库连接与行为。以下是一个典型配置示例：

# flyway.conf
flyway.url=jdbc:postgresql://localhost:5432/mydb
flyway.user=db_user
flyway.password=db_pass
flyway.locations=filesystem:./sql/migrations
flyway.baselineOnMigrate=true
flyway.encoding=UTF-8
flyway.cleanDisabled=true

3.1.3 常用命令速查

• flyway migrate — 执行待处理的迁移脚本。
• flyway info — 查看迁移状态与版本历史。
• flyway baseline — 对已有数据库建立基线版本。
• flyway validate — 校验已应用脚本是否被篡改。
• flyway repair — 修复迁移记录表（如删除失败的迁移条目）。

3.2 Maven 插件集成

对于基于 Maven 构建的 Java 项目，Flyway Maven 插件可以将数据库迁移无缝集成到构建生命周期中，实现 mvn compile 时自动执行迁移。

3.2.1 插件配置

在 pom.xml 的 <build><plugins> 中添加：

<plugin>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-maven-plugin</artifactId>
    <version>9.22.3</version>
    <configuration>
        <url>jdbc:mysql://localhost:3306/mydb</url>
        <user>${db.user}</user>
        <password>${db.password}</password>
        <locations>
            <location>classpath:db/migration</location>
        </locations>
        <baselineOnMigrate>true</baselineOnMigrate>
    </configuration>
</plugin>

3.2.2 常用 Maven 命令

3.3 Gradle 插件集成

Gradle 插件的配置方式与 Maven 类似，但更简洁，适合 Kotlin/Groovy 构建脚本。

3.3.1 插件配置（build.gradle）

plugins {
    id 'org.flywaydb.flyway' version '9.22.3'
}

flyway {
    url = 'jdbc:postgresql://localhost:5432/mydb'
    user = 'db_user'
    password = 'db_pass'
    locations = ['classpath:db/migration']
    baselineOnMigrate = true
}

3.3.2 常用 Gradle 任务

• gradle flywayMigrate
• gradle flywayInfo
• gradle flywayBaseline
• gradle flywayValidate

3.4 Spring Boot 自动配置集成

Spring Boot 对 Flyway 提供了开箱即用的自动配置，只需引入依赖并配置 application.yml 即可。

3.4.1 添加依赖

<!-- Maven -->
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>
<!-- 数据库驱动（以 PostgreSQL 为例） -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

3.4.2 配置文件（application.yml）

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/mydb
    username: db_user
    password: db_pass
  flyway:
    enabled: true
    locations: classpath:db/migration
    baseline-on-migrate: true
    clean-disabled: true
    encoding: UTF-8

3.4.3 关键配置项说明

3.5 配置优先级与最佳实践

Flyway 支持多种配置来源，优先级从高到低为：命令行参数 > 环境变量 > 配置文件 > 默认值。合理利用这一机制可以避免敏感信息泄露。

3.5.1 环境变量覆盖示例

# Linux/macOS
export FLYWAY_URL="jdbc:postgresql://prod-db:5432/proddb"
export FLYWAY_USER="prod_user"
export FLYWAY_PASSWORD="prod_pass"

# Windows PowerShell
$env:FLYWAY_URL="jdbc:postgresql://prod-db:5432/proddb"

3.5.2 多环境配置策略