SpringBoot从2.7.2升级到3.1.2构建时遇Flyway相关NoSuchMethodError问题

核心原因 #

SpringBoot 3.x全面切换到Jakarta EE API，旧版Flyway（8.x及以下）依赖Java EE API，两者不兼容导致方法找不到。另外，Gradle依赖中可能存在隐式依赖冲突，比如其他依赖引入低版本Flyway，覆盖了你指定的版本。

解决方案 #

1. 强制使用SpringBoot官方适配的Flyway版本 #

SpringBoot依赖管理已内置适配的Flyway版本，无需手动指定版本，直接引入依赖即可：

dependencies {
    implementation 'org.flywaydb:flyway-core'
    // 若使用特定数据库驱动，例如MySQL
    implementation 'org.flywaydb:flyway-mysql'
}

SpringBoot 3.1.2对应的Flyway适配版本为9.22.3，可通过./gradlew dependencies命令查看flyway-core的resolved version确认。

2. 排查并排除冲突的低版本Flyway依赖 #

执行命令查看依赖树，定位引入低版本Flyway的来源：

./gradlew dependencies --configuration runtimeClasspath | grep flyway

找到冲突依赖后，在对应依赖中排除低版本Flyway，示例：

dependencies {
    implementation('com.example:some-third-party-dependency') {
        exclude group: 'org.flywaydb', module: 'flyway-core'
    }
}

3. 检查自定义Flyway配置类 #

若项目中自定义了Flyway相关配置类（如继承或修改FlywayAutoConfiguration），需检查是否调用了SpringBoot 2.x存在但3.x已移除的方法。SpringBoot 3.x对Flyway自动配置类做了调整，部分方法签名和逻辑已变更，需适配新版本API。

4. 清理Gradle缓存 #

缓存的旧依赖可能引发问题，执行命令清理并刷新依赖：

./gradlew clean build --refresh-dependencies

验证步骤 #

1. 执行./gradlew dependencies确认Flyway版本为SpringBoot适配的9.x系列
2. 运行./gradlew build验证错误是否解决

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