执行mvn flyway:migrate报错：无法处理MySQL JDBC连接

核心排查与修复步骤 #

1. 匹配Flyway与MySQL版本兼容性 #

Flyway对MySQL版本有明确适配要求：

• MySQL 8.x 需搭配Flyway 6.0及以上版本
• MySQL 5.7及以下可使用Flyway 5.x或更高版本
  若Flyway版本过低，会直接无法识别MySQL 8的驱动逻辑或URL格式，触发找不到数据库处理类的错误。

2. 确保MySQL驱动依赖配置正确 #

必须在flyway-maven-plugin的依赖块中明确引入对应版本的MySQL驱动，避免全局依赖冲突：

<plugin>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-maven-plugin</artifactId>
    <version>8.5.13</version> <!-- 适配MySQL8的稳定版本 -->
    <configuration>
        <url>jdbc:mysql://localhost:3306/fooddeliverydb?serverTimezone=UTC</url>
        <user>你的数据库用户名</user>
        <password>你的数据库密码</password>
        <driver>com.mysql.cj.jdbc.Driver</driver> <!-- MySQL8必须使用该驱动类 -->
    </configuration>
    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.33</version> <!-- 与MySQL服务版本匹配 -->
        </dependency>
    </dependencies>
</plugin>

注意：MySQL 8.x的驱动类为com.mysql.cj.jdbc.Driver，老版本MySQL使用com.mysql.jdbc.Driver，驱动类写错也会导致识别失败。

3. 修正JDBC URL格式 #

MySQL 8.x的URL必须指定时区参数，否则驱动初始化失败，Flyway无法识别：

• 错误格式：jdbc:mysql://localhost:3306/fooddeliverydb
• 正确格式：jdbc:mysql://localhost:3306/fooddeliverydb?serverTimezone=UTC&useSSL=false
  同时确认URL中的fooddeliverydb数据库已在MySQL中创建，服务端口3306正常监听。

4. 清理缓存后重试 #

执行以下命令清理项目缓存并重新执行迁移：

mvn clean
mvn flyway:migrate

避免旧依赖缓存导致版本冲突。

额外排查点 #

• 用mvn dependency:tree查看项目依赖树，检查是否存在多个版本的MySQL驱动，排除冲突依赖。
• 再次验证MySQL服务状态，确认端口、数据库实例正常运行。

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