Spring Boot启动时Flyway未执行PostgreSQL迁移问题排查

问题场景 #

Spring Boot应用已引入Flyway依赖用于PostgreSQL数据库迁移，但启动时未执行任何迁移操作，无Flyway相关日志输出，数据库也无变更。

配置信息 #

1. pom.xml依赖：

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>10.20.0</version>
</dependency>

2. application.properties配置：

spring.flyway.enabled=true
spring.flyway.baseline-on-migrate=true
logging.level.org.flywaydb=DEBUG

spring.datasource.url=jdbc:postgresql://localhost:5432/mydb
spring.datasource.username=username
spring.datasource.password=password

3. 迁移文件：放置在resources/db/migration目录下，文件名为V1__initial_migration.init，内含建表语句。

启动日志片段 #

2024-11-17T12:59:30.239Z INFO 13224 --- [task_management] [ main] c.example.task_management.Application : No active profile set, falling back to 1 default profile: "default"
2024-11-17T12:59:32.364Z INFO 13224 --- [task_management] [main] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Start completed.
...
2024-11-17T12:59:33.917Z INFO 13224 --- [task_management] [ main] j.LocalContainerEntityManagerFactoryBean : Initialized JPA EntityManagerFactory for persistence unit 'default'
...
2024-11-17T12:59:34.813Z INFO 13224 --- [task_management] [ main] c.example.task_management.Application : Started Application in 5.045 seconds (process running for 5.497)

问题原因及解决方案 #

1. 迁移文件扩展名不符合Flyway规范 #

Flyway默认仅识别.sql扩展名的SQL迁移文件，你的文件使用.init扩展名，会被Flyway直接忽略，这是核心问题。

解决：将迁移文件重命名为V1__initial_migration.sql，确保扩展名符合要求。

2. 验证Flyway自动配置状态 #

若重命名后仍无日志输出，检查以下点：

• 确认spring.flyway.enabled=true未被其他配置（如多profile）覆盖。
• 检查Maven依赖是否完整，Flyway-core未被意外排除。
• 确认resources/db/migration目录未被打包工具忽略（可查看Maven的resources配置）。

3. 日志配置有效性检查 #

确认logging.level.org.flywaydb=DEBUG配置生效，部分日志框架可能会覆盖该级别设置，可尝试调整为TRACE级别进一步排查加载细节。

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