Flyway 通过 Maven 插件执行迁移时，不会自动读取 application.properties 中的数据库配置；必须在 pom.xml 的插件配置中显式声明 URL、用户名和密码等连接参数，否则将抛出“Unable to connect to the database”异常。
flyway 通过 maven 插件执行迁移时，不会自动读取 `application.properties` 中的数据库配置；必须在 `pom.xml` 的插件配置中显式声明 url、用户名和密码等连接参数，否则将抛出“unable to connect to the database”异常。
在 Spring Boot 项目中，开发者常误以为 spring.datasource.* 配置会被 Flyway Maven 插件自动继承——实际上，Maven 构建生命周期与 Spring 应用上下文完全隔离。当运行 mvn flyway:migrate 时，Flyway 仅依赖其插件自身的 <configuration></configuration> 块，而非 Spring 的配置文件。
✅ 正确配置方式（pom.xml）
需在 org.flywaydb:flyway-maven-plugin 插件中完整指定数据库连接信息：
<plugin><groupid>org.flywaydb</groupid><artifactid>flyway-maven-plugin</artifactid><version>9.16.3</version><configuration><!-- 必填：JDBC URL（注意使用 flyway 命名空间，非 spring.datasource） --><url>jdbc:postgresql://localhost:5432/candidate</url><user>myusername</user><password>mypassword</password><!-- 可选：指定 schema，默认 public --><schemas><schema>public</schema></schemas><!-- 可选：启用 baselineOnMigrate（等效于 spring.flyway.baseline-on-migrate=true） --><baselineonmigrate>true</baselineonmigrate><!-- 可选：指定 SQL 迁移脚本位置（默认 src/main/resources/db/migration） --><locations><location>classpath:db/migration</location></locations></configuration></plugin>
? 关键点说明：
<url></url>是必需字段，且必须为标准 JDBC 格式（如jdbc:postgresql://host:port/dbname）；<user></user>和<password></password>不可省略，即使数据库允许无密码登录，也需显式设为空字符串<password></password>；spring.flyway.*属性仅对 Spring Boot 自动配置的 Flyway Bean 生效，对 Maven 插件无效；- 若使用 Docker 或远程 PostgreSQL，请确保目标数据库已启动、端口可达、用户具备对应数据库的
CONNECT和CREATE权限。
✅ 验证与调试建议
-
测试连接可用性：
在终端执行psql -h localhost -U myusername candidate，确认凭据和网络连通性； -
启用 Flyway 日志：
添加<loglevel>DEBUG</loglevel>到插件配置，查看详细错误堆栈； -
避免敏感信息硬编码：
推荐使用 Maven 属性 +settings.xml加密或环境变量（如<url>${env.DB_URL}</url>），提升安全性。
完成上述配置后，执行以下命令即可成功触发迁移：
mvn flyway:migrate
若仍报错，请检查 PostgreSQL 日志（pg_log/）是否拒绝连接，或确认 flyway-maven-plugin 版本与 PostgreSQL JDBC 驱动兼容（推荐搭配 postgresql:42.6.x 及以上）。正确配置后，Flyway 将独立于 Spring 上下文完成元数据表创建与 SQL 脚本执行。
