在 Spring Boot 项目中，flyway.conf 文件中的 flyway.locations 属性常被忽略，导致自定义迁移路径不生效；根本原因在于 Flyway 的配置加载优先级与机制——Spring Boot 默认通过 application.properties/application.yml 或 Maven 插件配置驱动 Flyway，而独立 flyway.conf 文件仅在纯 Flyway CLI 场景下被原生识别。
在 spring boot 项目中，`flyway.conf` 文件中的 `flyway.locations` 属性常被忽略，导致自定义迁移路径不生效；根本原因在于 flyway 的配置加载优先级与机制——spring boot 默认通过 `application.properties`/`application.yml` 或 maven 插件配置驱动 flyway，而独立 `flyway.conf` 文件仅在纯 flyway cli 场景下被原生识别。
Flyway 的配置文件（如 flyway.conf）并非 Spring Boot 自动加载的配置源。Spring Boot 的 FlywayAutoConfiguration 仅读取 application.* 中以 spring.flyway.* 为前缀的属性，或通过 FlywayConfigurationCustomizer 编程式配置。因此，即使你在项目根目录放置了 flyway.conf，只要未显式启用 Flyway CLI 模式（例如通过 flyway migrate 命令行调用），该文件将被完全忽略。
✅ 正确做法有以下三种（推荐按顺序选用）：
1. 使用 Spring Boot 配置文件（最推荐）
在 src/main/resources/application.yml 中配置：
spring:
flyway:
locations: classpath:db/migration,classpath:com/example/db/migration
# 支持多个路径，用逗号分隔；自动解析 classpath 下的资源或 application.properties：
spring.flyway.locations=classpath:db/migration,classpath:com/example/db/migration
✅ 优势：与 Spring Boot 生命周期深度集成，支持 Profile 切换（如
application-dev.yml），且路径自动 classpath 扫描，无需额外构建配置。
2. 通过 Maven 插件显式指定（适用于构建时迁移）
若需在 mvn flyway:migrate 时生效，应在 pom.xml 中配置插件：
<plugin>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-maven-plugin</artifactId>
<configuration>
<locations>
<location>classpath:db/migration</location>
<location>classpath:com/example/db/migration</location>
</locations>
<url>jdbc:postgresql://test:5442/test</url>
<user>test</user>
<password>test</password>
</configuration>
</plugin>⚠️ 注意：此方式仅影响 Maven 插件执行（如 CI 环境），不影响应用启动时的自动迁移（由 Spring Boot 控制）。
3. 编程式配置（高级定制场景）
在 @Configuration 类中注册自定义 Flyway Bean：
@Bean
public Flyway flyway(DataSource dataSource) {
return Flyway.configure()
.dataSource(dataSource)
.locations("classpath:db/migration", "classpath:com/example/db/migration")
.schemas("test")
.load();
}✅ 适用：需动态计算路径、集成外部配置中心等复杂场景。
❌ 为什么 flyway.conf 不起作用？
-
flyway.conf是 Flyway CLI 的标准配置文件，仅当直接运行flyway migrate（非 Spring Boot 启动）时被加载； - Spring Boot 应用启动时，
FlywayAutoConfiguration不会扫描或解析flyway.conf； - 即使你误将
flyway.conf放入src/main/resources，它也不会被自动注入到 Flyway 实例中。
? 验证是否生效
启动应用后，观察日志中类似输出：
INFO o.f.c.i.l.c.CommandLineLocationProvider - Found location: classpath:db/migration INFO o.f.c.i.l.c.CommandlineLocationScanner - Scanning for SQL migrations in: classpath:com/example/db/migration
若未出现自定义路径的日志，则说明配置未生效。
总结
| 方式 | 生效时机 | 是否推荐 | 备注 |
|---|---|---|---|
application.yml / application.properties
|
Spring Boot 启动时自动迁移 | ✅ 强烈推荐 | 简洁、标准、可 Profile 化 |
Maven flyway-maven-plugin
|
mvn flyway:* 命令执行时 |
⚠️ 次选 | 仅限构建/部署阶段 |
flyway.conf 文件 |
Spring Boot 中默认无效 | ❌ 不推荐 | 仅适用于纯 CLI 场景 |
请始终优先使用 Spring Boot 原生配置机制，避免混淆 Flyway CLI 与框架集成的行为边界。
