Spring Boot项目中flyway.conf的flyway.locations属性失效问题排查

原因分析 #

1. Spring Boot配置优先级覆盖：Spring Boot整合Flyway时，会优先读取application.properties/application.yml中的Flyway配置，而非项目根目录的flyway.conf。如果Spring配置文件中存在Flyway相关配置，会直接覆盖flyway.conf的设置。
2. flyway.conf加载路径不正确：Flyway默认从当前工作目录或classpath根目录加载flyway.conf。若你用Spring Boot Maven/Gradle插件启动项目，当前工作目录可能不是项目根目录，导致配置文件未被加载。
3. locations配置格式错误：你配置的db.migration等价于classpath:db/migration，属于重复指定同一目录；同时未正确指定Java迁移类所在的包路径（源码中com.example.db.migration编译后对应classpath下的com/example/db/migration）。

正确配置步骤 #

方案1：改用Spring Boot配置文件（推荐） #

在src/main/resources/application.properties中配置：

# 同时指定Java迁移类和SQL迁移文件的位置
spring.flyway.locations=classpath:com/example/db/migration,classpath:db/migration
spring.flyway.user=test
spring.flyway.password=test
spring.flyway.schemas=test
spring.flyway.url=jdbc:postgresql://test:5442/test

注：Java迁移类的路径对应编译后的classpath包路径，需和源码包结构一致。

方案2：确保flyway.conf被正确加载 #

若坚持使用flyway.conf：

1. 将flyway.conf移动到src/main/resources目录下（使其进入classpath）。
2. 修正locations配置：

flyway.locations=classpath:com/example/db/migration,classpath:db/migration
flyway.user=test
flyway.password=test
flyway.schemas=test
flyway.url=jdbc:postgresql://test:5442/test

3. 若用Maven插件启动，可在插件配置中指定flyway.conf路径：

<plugin>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-maven-plugin</artifactId>
    <version>你的Flyway版本</version>
    <configuration>
        <configFiles>../flyway.conf</configFiles>
    </configuration>
</plugin>

验证配置有效性 #

添加日志级别为DEBUG，查看Flyway加载的配置详情：

logging.level.org.flywaydb=DEBUG

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