升级Liquibase Gradle插件至3.0.1时出现liquibase.Scope类加载错误

环境配置 #

• SDK 21.0.9
• Gradle 8.14
• 全新IntelliJ Kotlin项目

2.2.2版本 - 构建成功 #

plugins {
    kotlin("jvm") version "2.2.20"
    id("org.liquibase.gradle") version "2.2.2"
}

group = "org.example"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
}

dependencies {
    liquibaseRuntime("org.liquibase:liquibase-core:4.33.0")
    liquibaseRuntime("org.postgresql:postgresql")
    liquibaseRuntime("org.yaml:snakeyaml")
    liquibaseRuntime("ch.qos.logback:logback-core")
    liquibaseRuntime("ch.qos.logback:logback-classic")
    liquibaseRuntime("info.picocli:picocli:4.7.5")

    testImplementation(kotlin("test"))
}

tasks.test {
    useJUnitPlatform()
}
kotlin {
    jvmToolchain(21)
}

3.0.1版本 - 构建失败 #

plugins {
    kotlin("jvm") version "2.2.20"
    id("org.liquibase.gradle") version "3.0.1"
}

group = "org.example"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
}

dependencies {
    liquibaseRuntime("org.liquibase:liquibase-core:4.33.0")
    liquibaseRuntime("org.postgresql:postgresql")
    liquibaseRuntime("org.yaml:snakeyaml")
    liquibaseRuntime("ch.qos.logback:logback-core")
    liquibaseRuntime("ch.qos.logback:logback-classic")
    liquibaseRuntime("info.picocli:picocli:4.7.5")

    testImplementation(kotlin("test"))
}

tasks.test {
    useJUnitPlatform()
}
kotlin {
    jvmToolchain(21)
}

错误信息 #

Unable to load class 'liquibase.Scope'.

* What went wrong:
liquibase/Scope
> liquibase.Scope

解决方案 #

这个错误的核心原因是Liquibase Gradle插件3.0.1版本与当前使用的liquibase-core 4.33.0版本不兼容。插件3.x系列对核心库的版本要求有所提升，旧版本核心库的类结构和加载逻辑无法适配新插件。

你只需做以下调整即可解决问题：

1. 将liquibase-core的版本升级到与插件3.0.1兼容的版本，官方推荐升级到4.35.0及以上版本；
2. 修改依赖声明中的liquibase-core版本：

liquibaseRuntime("org.liquibase:liquibase-core:4.35.0")

调整完成后重新执行构建，类加载失败的问题即可解决。

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