Docker环境下Flyway迁移文件名格式不识别问题求助

问题复现 #

• IDE本地运行时，Flyway迁移正常执行：

  INFO: Successfully applied 1 migration to schema `db`, now at version v1
  

• Docker容器中运行应用时抛出异常：

  example  | Exception in thread "main" 
  example  | org.flywaydb.core.api.FlywayException: Invalid SQL filenames found:
  example  | Unrecognised migration name format: V1__Example.sql
  

调试发现容器环境无法加载CoreResourceTypeProvider，导致缺少迁移文件的前缀规则配置。

解决思路 #

1. 验证打包后迁移文件的完整性与路径 #

• 检查Maven/Gradle构建脚本，确保SQL迁移文件（如V1__Example.sql）被正确打包进Jar包，未被资源过滤规则排除。例如在Maven的pom.xml中添加：

  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <includes>
          <include>db/migration/**/*.sql</include>
        </includes>
      </resource>
    </resources>
  </build>
  

• 进入Docker容器，执行jar tf <你的应用Jar包>命令，确认迁移文件的路径、文件名与本地IDE中完全一致，无大小写或路径层级差异。

2. 排查Flyway SPI加载异常 #

• 检查Jar包内是否存在META-INF/services/org.flywaydb.core.api.resource.ResourceTypeProvider文件，且文件内容包含org.flywaydb.core.internal.resource.type.CoreResourceTypeProvider——这是Flyway通过SPI机制加载资源类型规则的关键配置。
• 若使用Spring Boot，确保引入的是spring-boot-starter-flyway依赖而非单独的Flyway核心包，避免starter自动配置的SPI规则缺失。

3. 消除Docker环境的依赖冲突或类路径问题 #

• 执行docker exec <容器ID> java -cp <你的应用Jar包> org.flywaydb.core.internal.util.VersionPrinter，确认容器内运行的Flyway版本与本地IDE完全一致，排除多版本依赖冲突。
• 尝试更换Docker基础镜像，比如从轻量的Alpine镜像换成官方OpenJDK镜像（如openjdk:17-jdk-slim），避免轻量镜像的类路径处理差异导致SPI加载失败。

4. 显式配置Flyway迁移规则 #

若SPI自动加载确实存在问题，可在代码中显式指定迁移文件的前缀、分隔符规则，绕过自动加载逻辑：

Flyway flyway = Flyway.configure()
    .dataSource(jdbcUrl, username, password)
    .sqlMigrationPrefix("V")
    .sqlMigrationSeparator("__")
    .sqlMigrationSuffixes(".sql")
    .load();
flyway.migrate();

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