多模块Gradle项目中Liquibase配置迁移至约定插件的问题

我有一个多模块Java/Gradle项目，所有模块配置完全一致，打算迁移为预编译脚本插件形式的Gradle约定插件，但集成liquibase-gradle-plugin时遇到两个核心问题：

问题1：liquibaseRuntime依赖作用域无法识别 #

在约定插件的依赖块中使用自定义的liquibaseRuntime作用域时：

dependencies {
    implementation libs.plugins.jooq.liquibase
    implementation libs.plugins.gradle.liquibase

    liquibaseRuntime libs.postgresql
    liquibaseRuntime libs.liquibase
    liquibaseRuntime libs.jooq
    liquibaseRuntime libs.picocli
}

运行时报错：

Caused by: org.gradle.internal.metaobject.AbstractDynamicObject$CustomMessageMissingMethodException: Could not find method liquibaseRuntime() for arguments [map(valueof(DependencyValueSource))] on object of type org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler.
    at org.gradle.internal.metaobject.AbstractDynamicObject$CustomMissingMethodExecutionFailed.<init>(AbstractDynamicObject.java:190)
    at org.gradle.internal.metaobject.AbstractDynamicObject.methodMissingException(AbstractDynamicObject.java:184)
    at org.gradle.internal.metaobject.ConfigureDelegate.invokeMethod(ConfigureDelegate.java:80)

将liquibaseRuntime替换为implementation可消除错误，但这些依赖仅用于Liquibase插件，不希望被导出。

问题2：liquibase配置闭包无法在约定插件中使用 #

将Liquibase的配置闭包写入约定插件时：

liquibase{
    activities {
        main {
            changeLogFile "src/main/liquibase/changelog.xml"
            // 更多配置
        }
    }
}

运行时报错：

Caused by: java.lang.RuntimeException: 
org.gradle.internal.metaobject.AbstractDynamicObject$CustomMessageMissingMethodException:
Could not find method liquibase() for arguments [precompiled_EsrJooqLiquibase$_run_closure3@664b65b8] on project ':moduleA' of type org.gradle.api.Project.

解决方案 #

处理liquibaseRuntime作用域 #

需手动注册liquibaseRuntime配置域，确保依赖能被正确识别且不对外导出：

// 先注册配置域
project.configurations.maybeCreate("liquibaseRuntime")
// 再声明依赖
dependencies {
    liquibaseRuntime(libs.postgresql)
    liquibaseRuntime(libs.liquibase)
    liquibaseRuntime(libs.jooq)
    liquibaseRuntime(libs.picocli)
}

处理liquibase配置闭包 #

通过显式获取并配置Liquibase扩展的方式替代直接闭包调用，避免动态方法找不到的问题：

project.extensions.configure(org.liquibase.gradle.LiquibaseExtension) { liquibase ->
    liquibase.activities { activities ->
        // 创建main活动并配置
        activities.create('main') { activity ->
            activity.changeLogFile = "src/main/liquibase/changelog.xml"
            // 添加其他所需配置
        }
    }
}

关键前提 #

确保在约定插件中先正确应用Liquibase插件，可通过版本目录或直接声明插件ID完成：

plugins {
    id 'org.liquibase.gradle' version libs.plugins.gradle.liquibase.version
}

内容的提问来源于stack exchange，提问作者Sean Patrick Floyd