配置Flyway与PostgreSQL数据库迁移时遇异常求助

一、修复"No database found to handle jdbc:postgresql://localhost:5432/postgres"错误 #

• 版本兼容性检查：Flyway与PostgreSQL JDBC驱动版本必须匹配，比如Flyway 10.x需搭配42.5+版本的postgresql驱动，Flyway 9.x对应42.2+版本。调整pom.xml中依赖版本，确保二者版本适配。
• 修正驱动依赖作用域：用Maven命令行执行迁移时，postgresql驱动的作用域不能设为runtime或provided，必须改为compile，否则命令行环境无法加载驱动类。
• 校验JDBC URL格式：确保URL拼写正确，jdbc:postgresql://前缀不能写错（注意是postgresql全拼，不是postgres）；若密码包含@、&等特殊字符，需做URL编码。
• 排除冲突依赖：执行mvn dependency:tree查看依赖树，排查是否存在其他数据库驱动（如H2、MySQL）或重复的Flyway依赖导致类加载冲突，通过<exclusions>标签排除冲突项。

二、解决迁移文件被忽略的问题 #

• 严格遵循命名规则：迁移文件必须符合V<数字版本号>__<描述文本>.sql格式，比如V1__init_user_table.sql，注意是两个下划线分隔版本和描述，版本号必须以数字开头，不能包含特殊字符。
• 确认文件存放路径：默认扫描路径是src/main/resources/db/migration，如果自定义了路径，需在配置中指定：
  • application.properties：flyway.locations=classpath:db/migration（可添加多个路径，用逗号分隔）
  • Maven插件配置：在pom.xml的flyway-maven-plugin中设置<locations>参数
• 检查迁移启用状态：确保application.properties中没有flyway.enabled=false配置，Maven插件也未禁用迁移功能。
• 查看DEBUG日志定位问题：执行mvn flyway:migrate -X开启调试日志，查看日志中关于迁移文件的扫描记录：
  • 是否扫描到目标SQL文件
  • 是否因版本号已存在于schema_history表中而跳过（若之前执行过同版本迁移，Flyway会默认跳过）

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