Spring Boot+Java8环境Flyway初始化失败报IllegalArgumentException

我之前帮同事排查过完全一样的问题，核心原因基本都是Flyway与Spring Boot版本不兼容，或者项目依赖中混入了不同版本的Flyway包，导致枚举类加载时出现不匹配。下面给你几个靠谱的解决方向：

一、先排查版本兼容性问题 #

Spring Boot的自动配置模块对Flyway的版本有严格的适配要求，如果你的项目手动指定了Flyway版本，很容易出现版本不匹配的情况：

• 如果你用的是Java 8，最高只能用Spring Boot 2.7.x系列，对应的Flyway版本最高是7.x（Spring Boot 3.x开始要求Java 17+，适配Flyway 8+）。
• 最稳妥的方式是不要手动指定Flyway版本，直接使用Spring Boot的starter依赖，让Spring Boot自动管理兼容版本：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-flyway</artifactId>
  </dependency>
  

二、清理依赖树中的冲突包 #

有时候项目里的其他依赖会间接引入不同版本的Flyway，导致类加载冲突。你可以用以下命令查看依赖树：

• Maven：mvn dependency:tree
• Gradle：./gradlew dependencies
  找到所有org.flywaydb相关的依赖，排除掉多余的版本。比如如果有第三方依赖引入了旧版Flyway，可以这样排除：

<dependency>
    <groupId>第三方依赖groupId</groupId>
    <artifactId>第三方依赖artifactId</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.flywaydb</groupId>
            <artifactId>flyway-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

三、验证迁移文件的规范性 #

虽然这个报错是枚举类问题，但也有可能是迁移文件命名不符合Flyway规范导致的异常触发。确保你的迁移文件遵循V{版本号}__{描述}.sql（版本迁移）或U{版本号}__{描述}.sql（回滚迁移）的格式，不要用特殊字符或不符合规则的命名。

最后一步：清理缓存重新构建 #

做完上面的调整后，清理项目依赖缓存再重新构建：

• Maven：mvn clean install -U
• Gradle：./gradlew clean build --refresh-dependencies
  然后重启项目，应该就能解决这个初始化异常了。

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