使用Flyway-Ant执行Ant构建时无法识别JDBC URL问题求助

问题重现 #

配置Ant构建调用Flyway-Ant时，执行flyway:info目标报错：

Flyway Error: No database found to handle jdbc:mariadb://<some_host>:3306/<some_db>

使用MySQL JDBC URL时出现相同问题。已将flyway-core、flyway-mysql、flyway-ant及对应JDBC驱动打包进胖JAR，且相同依赖配置在Spring Boot应用中可正常运行。当前版本：Flyway Core 8.5.13，Flyway-Ant 2.19.3。

核心原因 #

Flyway-Ant 2.19.3属于老旧版本，对应Flyway Core 2.x系列，与你使用的Flyway Core 8.5.13版本完全不兼容。两者的SPI加载机制、数据库类型实现类结构差异极大，导致无法识别JDBC URL对应的数据库类型。

解决思路 #

1. 统一Flyway版本 #

替换flyway-ant依赖为与Flyway Core 8.5.13匹配的版本（Flyway从5.x开始，Ant插件版本与Core版本保持一致），即使用flyway-ant:8.5.13。更新胖JAR，确保包含该版本的Ant插件，移除旧版本的flyway-ant。

2. 检查胖JAR的SPI文件完整性 #

Flyway通过Java SPI加载数据库类型实现，需确保胖JAR中合并了所有依赖的SPI配置：

• 打开胖JAR，查看META-INF/services/org.flywaydb.core.internal.database.DatabaseType文件，内容需包含：

  org.flywaydb.core.internal.database.mysql.MySQLDatabaseType
  org.flywaydb.core.internal.database.mariadb.MariaDBDatabaseType
  

• 若文件缺失或内容不全，调整打包配置（如使用Maven Shade插件时，添加ServicesResourceTransformer来合并SPI文件）。

3. 验证Ant类路径配置 #

• 确认flyway.lib.path和flyway.classpath均正确指向胖JAR，无路径错误或依赖遗漏。
• 添加Ant任务打印类路径进行验证：

  <target name="check-classpath">
      <echo message="Flyway lib classpath: ${toString:flyway.lib.path}"/>
      <echo message="Flyway classpath: ${toString:flyway.classpath}"/>
  </target>
  

4. 临时 workaround：显式指定数据库类型 #

若上述步骤暂时无法落地，可在Ant目标中强制指定数据库类型：

<target name="db-info">
    <property name="flyway.url" value="jdbc:mariadb://<some_host>:3306/<some_db>" />
    <property name="flyway.user" value="some_user" />
    <property name="flyway.password" value="psst!" />
    <property name="flyway.databaseType" value="mariadb" /> <!-- MySQL则填mysql -->
    <flyway:info/>
</target>

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