Spring Boot Native模式下Flyway扫描报错但迁移成功问题咨询

报错性质说明 #

这个报错属于无影响的冗余信息，不会干扰迁移脚本的正常扫描和执行。原因是Flyway在原生镜像环境下，会优先尝试JVM标准的类路径扫描方式访问/db/migration，但原生镜像的资源存储机制与常规JVM不同，导致扫描时抛出协议不支持的异常；不过Flyway内部会自动切换到适配原生镜像的 fallback 扫描逻辑，最终仍能正确定位并执行迁移脚本。

消除报错的方法 #

1. 明确配置Flyway扫描路径 #

在application.properties或application.yml中显式指定迁移脚本的类路径位置，替换默认的相对路径写法，让Flyway直接使用适配类路径的扫描逻辑：

# application.properties
spring.flyway.locations=classpath:/db/migration

或者YAML格式：

# application.yml
spring:
  flyway:
    locations: classpath:/db/migration

2. 配置原生镜像插件的资源规则 #

如果使用Maven或Gradle的原生镜像构建插件，可以提前标记/db/migration目录下的资源为可扫描资源，让原生镜像工具预处理这些资源，避免Flyway扫描时触发异常。以Maven插件为例：

<plugin>
  <groupId>org.graalvm.buildtools</groupId>
  <artifactId>native-maven-plugin</artifactId>
  <configuration>
    <resources>
      <resource>
        <directory>src/main/resources/db/migration</directory>
      </resource>
    </resources>
  </configuration>
</plugin>

3. 升级Flyway版本 #

Flyway在9.22.0及后续版本中优化了原生镜像环境下的资源扫描逻辑，修复了该冗余报错问题。可以将flyway-core升级到与Spring Boot 3.1.x兼容的最新版本，从根源上解决这个问题。

内容的提问来源于stack exchange，提问作者Денис Анд