Flyway问题：Gradle执行迁移报错，SpringBoot可正常连接MariaDB

我尝试通过Gradle的Flyway插件执行数据库迁移脚本，相关配置如下：

build.gradle 配置 #

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.1'
    id 'io.spring.dependency-management' version '1.1.4'
    id "org.flywaydb.flyway" version "10.0.0"
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '17'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.mariadb.jdbc:mariadb-java-client'
    implementation 'org.flywaydb:flyway-mysql'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

flyway {
    url = 'jdbc:mariadb://localhost:3307/something'
    user = 'root'
    driver = 'org.mariadb.jdbc.Driver'
}

application.properties 配置 #

# MySQL Configuration
spring.datasource.url=jdbc:mariadb://localhost:3307/something
spring.datasource.username=root
spring.datasource.driver-class-name=org.mariadb.jdbc.Driver
spring.jpa.show-sql=true

执行 gradlew flywayMigrate 命令时，收到错误：

Execution failed for task ':flywayMigrate'.
> Error occurred while executing flywayMigrate
  No database found to handle jdbc:mariadb://localhost:3307/something

但启动Spring Boot应用时迁移脚本可正常执行，说明驱动和连接配置没有问题，请问该如何解决？

问题核心是Gradle Flyway插件的classpath未包含MariaDB驱动：你声明的mariadb-java-client是implementation依赖，仅会加入应用程序的classpath，而Flyway Gradle插件运行时使用独立classpath，无法访问该驱动。

方式一：给Flyway插件单独配置驱动依赖 #

修改build.gradle，添加buildscript块将驱动加入插件classpath：

plugins {
    // 保留原有插件配置
}

// 新增配置：为Flyway插件提供驱动依赖
buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'org.mariadb.jdbc:mariadb-java-client:3.3.3' // 版本可与应用依赖保持一致
        classpath 'org.flywaydb:flyway-mysql:10.0.0' // 与你使用的Flyway版本匹配
    }
}

// 其余原有配置不变...

方式二：利用Spring Boot自动配置执行迁移（推荐） #

既然Spring Boot启动时能正常执行迁移，可直接通过Spring Boot任务触发，无需使用Flyway独立插件：

1. 确保application.properties中Flyway启用（默认已启用，可显式添加）：

spring.flyway.enabled=true

2. 执行迁移的两种方式：
   • 启动应用时自动执行：

     gradlew bootRun
     

   • 仅执行迁移不启动应用：在build.gradle中添加自定义任务

     task migrateDatabase(type: JavaExec) {
         classpath = sourceSets.main.runtimeClasspath
         mainClass = 'org.springframework.boot.loader.JarLauncher'
         args = ['--spring.main.web-application-type=NONE']
     }
     

     然后执行：

     gradlew migrateDatabase
     

补充说明 #

• flyway-mysql模块同时支持MySQL和MariaDB，但必须保证对应JDBC驱动存在于运行时classpath；
• 若坚持使用Flyway Gradle插件，需确保buildscript中的驱动版本与应用依赖版本一致，避免版本冲突。

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