如何在Travis构建流程中规范使用Flyway？

我之前也踩过手动下载Flyway的坑——不仅慢，还经常遇到链接失效的问题。下面分享几个亲测好用的实践方案，按推荐程度排序：

1. 优先用构建工具插件（Java项目首选） #

如果你的项目是Maven或Gradle构建的，直接用Flyway官方插件是最省心的，完全不用单独安装Flyway程序：

Maven 示例 #

在pom.xml里配置Flyway插件：

<build>
  <plugins>
    <plugin>
      <groupId>org.flywaydb</groupId>
      <artifactId>flyway-maven-plugin</artifactId>
      <version>9.22.3</version>
      <configuration>
        <url>${db.url}</url>
        <user>${db.user}</user>
        <password>${db.password}</password>
      </configuration>
    </plugin>
  </plugins>
</build>

然后在.travis.yml里直接执行迁移命令：

script:
  - mvn flyway:migrate

版本号可以根据项目需求调整，Maven会自动从中央仓库拉取依赖，Travis还会缓存这些依赖，速度非常快。

Gradle 示例 #

在build.gradle中添加Flyway插件：

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

flyway {
  url = System.getenv('DB_URL')
  user = System.getenv('DB_USER')
  password = System.getenv('DB_PASSWORD')
}

Travis配置：

script:
  - ./gradlew flywayMigrate

2. 使用官方Docker镜像（通用方案） #

如果不是Java项目，或者不想依赖构建工具，用Flyway官方Docker镜像更靠谱——不用处理下载解压，版本可控，还由官方维护：

在.travis.yml里先确保Docker可用（Travis默认支持），然后直接运行镜像执行迁移：

services:
  - docker

script:
  - docker run --rm \
      -v $(pwd)/src/main/resources/db/migration:/flyway/sql \ # 映射你的SQL脚本目录
      flyway/flyway:9.22.3 \
      migrate \
      -url=jdbc:mysql://localhost:3306/your_db \
      -user=root \
      -password=$DB_PASSWORD # 用Travis加密环境变量存密码

注意：如果你的数据库也是在Travis里启动的（比如MySQL），要确保数据库服务先完全启动，容器能访问到主机的数据库——可以用host.docker.internal作为主机名，或者把数据库也放在Docker里用网络连接。

3. 优化手动下载（备选方案） #

如果以上两种都不适用，你可以用Travis的缓存机制优化手动下载，避免每次构建都重新下载。推荐从Maven中央仓库下载，比官网链接更稳定（有CDN支持）：

cache:
  directories:
    - $HOME/flyway # 缓存Flyway目录

before_install:
  # 检查缓存是否存在，不存在才下载
  - if [ ! -d $HOME/flyway ]; then 
      wget -q https://repo1.maven.org/maven2/org/flywaydb/flyway-commandline/9.22.3/flyway-commandline-9.22.3-linux-x64.tar.gz -O flyway.tar.gz;
      tar xzf flyway.tar.gz -C $HOME;
      mv $HOME/flyway-* $HOME/flyway;
      rm flyway.tar.gz;
    fi
  - export PATH=$HOME/flyway:$PATH # 把Flyway加入系统PATH

script:
  - flyway migrate -url=$DB_URL -user=$DB_USER -password=$DB_PASSWORD

第一次构建会下载Flyway，之后的构建直接用缓存的版本，速度提升明显。

额外注意事项 #

• 版本锁定：不管用哪种方案，都要指定具体的Flyway版本，避免自动升级带来的兼容性问题。
• 敏感信息：数据库密码等敏感信息不要硬编码，用Travis的加密环境变量（执行travis encrypt DB_PASSWORD=your_secret生成）存储。
• 数据库预热：在执行Flyway迁移前，确保Travis里的数据库服务已经完全启动，可以加个小脚本等待就绪：

  - until mysqladmin ping -h"localhost" -u"root" -p"$DB_PASSWORD" --silent; do sleep 1; done
  

内容的提问来源于stack exchange，提问作者brafdlog