Flyway为何在已有全部历史迁移执行时仍不跳过基线迁移？

为什么生产库会执行V2_0__baseline？ #

这不是Flyway的预期行为，核心问题出在配置逻辑和迁移文件的定位错误：

• 你的生产库已经有V1_249、V1_250这些迁移记录，Flyway会把V2_0__baseline当成一个普通的高版本迁移（版本2.0 > 现有最高版本1.250），再加上你开启了out-of-order: true，所以会直接执行这个迁移。
• baseline-version和baseline-on-migrate的作用是：仅当数据库的schema_version表为空时，才会创建基线并执行基线相关操作。你的生产库已有迁移记录，这两个配置不会生效，自然无法跳过V2_0__baseline。

解决思路与具体方案 #

你的需求是：空库快速用基线初始化，生产库跳过基线迁移且保留原有历史。以下是两种可靠方案：

方案一：修改V2_0__baseline的执行逻辑，让它自动判断是否跳过 #

直接在Java迁移里加判断，仅当数据库无迁移记录时才执行基线SQL：

@Component
public class V2_0__baseline extends BaseJavaMigration {
    private final ResourceLoader resourceLoader;

    public V2_0__baseline(ResourceLoader resourceLoader) {
        this.resourceLoader = resourceLoader;
    }

    @Override
    public void migrate(Context context) throws Exception {
        // 检查schema_version表是否存在且已有迁移记录
        boolean hasExistingMigrations = false;
        Connection conn = context.getConnection();
        
        // 检查表是否存在
        ResultSet tableRs = conn.getMetaData().getTables(null, null, "schema_version", new String[]{"TABLE"});
        if (tableRs.next()) {
            // 检查表中是否有记录
            PreparedStatement countStmt = conn.prepareStatement("SELECT COUNT(*) FROM schema_version");
            ResultSet countRs = countStmt.executeQuery();
            if (countRs.next() && countRs.getInt(1) > 0) {
                hasExistingMigrations = true;
            }
            countRs.close();
            countStmt.close();
        }
        tableRs.close();

        if (hasExistingMigrations) {
            // 已有迁移记录，直接跳过
            return;
        }

        // 执行基线SQL的原有逻辑
        Resource resource = resourceLoader.getResource("classpath:baseline/baseline.sql");
        Scanner scanner = new Scanner(resource.getInputStream(), StandardCharsets.UTF_8.name());
        String sql = scanner.useDelimiter("\\A").next();

        conn.createStatement().execute(sql);
    }
}

同时调整Flyway配置，将基线版本设为生产库已有的最高版本：

flyway:
    out-of-order: true
    enabled: true
    baseline-version: 1.250  # 改为生产库已有的最高迁移版本
    baseline-on-migrate: true
    baseline-description: My baseline

这样修改后：

• 空库：schema_version表不存在，执行基线SQL初始化。
• 生产库：已有迁移记录，直接跳过V2_0__baseline的执行。

方案二：改用Flyway原生基线机制，移除V2_0__baseline迁移 #

放弃创建V2_0__baseline.java，直接用Flyway的基线SQL功能：

1. 移除V2_0__baseline.java文件。
2. 修改Flyway配置：

flyway:
    out-of-order: true
    enabled: true
    baseline-version: 1.250  # 生产库已有最高版本
    baseline-on-migrate: true
    baseline-description: My baseline
    baseline-sql: classpath:baseline/baseline.sql  # 指定你的基线SQL脚本

3. 后续新的迁移从V2_1__xxx开始命名。
   这个方案的效果：

• 空库执行迁移时，Flyway会自动执行baseline.sql，并将数据库版本标记为1.250，后续新迁移正常执行。
• 生产库已有1.250的迁移记录，Flyway会跳过基线操作，直接执行后续新迁移（如果有的话）。

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