如何通过Spring Boot BOM管理Gradle中Flyway插件的版本？

1. 自动将Flyway插件版本对齐Spring Boot BOM版本 #

Spring Boot的依赖管理机制可以帮你自动绑定Flyway插件版本到BOM指定的兼容版本，无需手动硬编码。具体实现分两种方式：

方式一：通过settings.gradle.kts统一管理插件版本

在项目根目录的settings.gradle.kts中添加pluginManagement块，利用Spring Boot BOM的版本属性解析Flyway插件版本：

pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
    plugins {
        id("org.springframework.boot") version "3.4.0"
        id("io.spring.dependency-management") version "1.1.6"
    }
    resolutionStrategy {
        eachPlugin {
            if (requested.id.id == "org.flywaydb.flyway") {
                // 从Spring Boot BOM中获取兼容的Flyway版本
                val flywayVersion = dependencies.create("org.flywaydb:flyway-core").version
                useVersion(flywayVersion)
            }
        }
    }
}

之后在build.gradle.kts的plugins块中，直接应用Flyway插件即可，无需指定版本：

plugins {
    kotlin("plugin.spring")
    id("org.springframework.boot")
    id("io.spring.dependency-management")
    id("org.flywaydb.flyway") // 自动使用BOM兼容版本
}

方式二：依赖Spring Boot Flyway Starter简化配置

如果项目中已经引入spring-boot-starter-flyway，插件版本会自动与starter版本对齐，此时甚至不需要额外配置版本解析：

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-flyway")
}

2. 确保Gradle插件与Spring Boot版本兼容 #

• 依赖Spring Boot官方兼容性矩阵：Spring Boot的BOM已经为所有配套组件完成兼容性测试，自动对齐版本就能避免绝大多数兼容性问题。
• 限制Renovate独立更新Flyway插件：在renovate.json中添加规则，禁止Renovate单独更新Flyway插件，仅允许随Spring Boot版本同步更新：

  {
    "packageRules": [
      {
        "matchPackageNames": ["org.flywaydb.flyway"],
        "matchManagers": ["gradle"],
        "enabled": false,
        "description": "Flyway版本由Spring Boot BOM管理，禁止独立更新"
      }
    ]
  }
  

• 升级Spring Boot时同步组件版本：每次升级Spring Boot版本时，对应的Flyway等组件版本会自动同步到兼容版本，此时通过Renovate更新Spring Boot即可完成整套依赖的兼容升级。
• 查看Spring Boot发布说明：升级前可以查阅Spring Boot官方发布文档，确认目标版本支持的第三方组件版本范围，提前规避风险。

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