拆分含bmuschko Gradle Docker插件的构建文件报错求助

我是Gradle脚本新手，尝试将现有build.gradle拆分为两个文件，但执行./gradlew createAppImage时遇到错误，另外两个Docker任务可正常运行，将代码合并回单个文件则无异常。拆分后的文件如下：

拆分后的build.gradle #

buildscript {
    ext {
        springBootVersion = '1.5.12.RELEASE'
        gradleDockerVersion = '3.2.7'
    }
    repositories {
        jcenter()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
        classpath("com.bmuschko:gradle-docker-plugin:${gradleDockerVersion}")
    }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'idea'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'

jar {
    baseName = 'gs-spring-boot'
    version = '0.1.0'
}

repositories {
    mavenCentral()
}

sourceCompatibility = 1.8
targetCompatibility = 1.8
compileJava.options.encoding = 'UTF-8'

dependencies {
    compile("org.springframework.boot:spring-boot-starter-web")
    testCompile("junit:junit")
}

project.ext.imageName = 'myImage'
project.ext.tagName ='myTag'
project.ext.jarName = (jar.baseName + '-' + jar.version).toLowerCase()

apply from: 'dockerapp.gradle'

拆分后的dockerapp.gradle #

def gradleDockerVersion = '3.7.2'

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath("com.bmuschko:gradle-docker-plugin:${gradleDockerVersion}")
    }
}

apply plugin: 'com.bmuschko.docker-remote-api'

import com.bmuschko.gradle.docker.tasks.image.DockerBuildImage
import com.bmuschko.gradle.docker.tasks.image.DockerRemoveImage
import com.bmuschko.gradle.docker.tasks.image.Dockerfile

def imageName = project.ext.imageName
def tagName = project.ext.tagName
def jarName = project.ext.jarName

task createAppDockerfile(type: Dockerfile) {
    // Don't create dockerfile if file already exists
    onlyIf { !project.file('Dockerfile').exists() }
    group 'Docker'
    description 'Generate docker file for the application'
    dependsOn bootRepackage
    destFile = project.file('Dockerfile')
    String dockerProjFolder = project.projectDir.name

    from 'openjdk:8-jre-slim'
    runCommand("mkdir -p /app/springboot/${dockerProjFolder} && mkdir -p /app/springboot/${dockerProjFolder}/conf")
    addFile("./build/libs/${jarName}.jar", "/app/springboot/${dockerProjFolder}/")
    environmentVariable('CATALINA_BASE', "/app/springboot/${dockerProjFolder}")
    environmentVariable('CATALINA_HOME', "/app/springboot/${dockerProjFolder}")
    workingDir("/app/springboot/${dockerProjFolder}")

    if (System.properties.containsKey('debug')) {
        entryPoint('java', '-Xdebug', '-Xrunjdwp:server=y,transport=dt_socket,address=5005,suspend=n', '-jar', "/app/springboot/${dockerProjFolder}/${jarName}.jar")
    } else {
        entryPoint('java', '-jar', "/app/springboot/${dockerProjFolder}/${jarName}.jar")
    }
}

task removeAppImage(type: DockerRemoveImage) {
    group 'Docker'
    description 'Remove the docker image using force'
    force = true
    targetImageId { imageName }

    onError { exception ->
        if (exception.message.contains('No such image')) {
            println 'Docker image not found for the current project.'
        }
    }
}

task createAppImage(type: DockerBuildImage) {
    group 'Docker'
    description 'Executes bootRepackage, generates a docker file and builds image from it'
    dependsOn(createAppDockerfile, removeAppImage)
    dockerFile = createAppDockerfile.destFile
    inputDir = dockerFile.parentFile

    if (tagName)
        tag = "${tagName}"
    else if (imageName)
        tag = "${imageName}"
    else
        tag = "${jarName}"
}

执行./gradlew createAppImage时的错误提示：

Could not get unknown property 'DockerBuildImage' for root project 'gs-spring-boot' of type org.gradle.api.Project.

这个问题的核心是重复定义buildscript块导致的类加载冲突和版本不一致：主脚本引入了3.2.7版本的docker插件，子脚本又重新引入3.7.2版本，Gradle的类加载机制因此出现混乱，导致DockerBuildImage这类任务类无法被正确识别。按以下步骤修改即可解决：

1. 移除子脚本中的buildscript块 #

将dockerapp.gradle里的buildscript块和本地定义的gradleDockerVersion变量完全删除，所有插件的类路径依赖统一放在主脚本的buildscript中。修改后的dockerapp.gradle开头如下：

apply plugin: 'com.bmuschko.docker-remote-api'

import com.bmuschko.gradle.docker.tasks.image.DockerBuildImage
import com.bmuschko.gradle.docker.tasks.image.DockerRemoveImage
import com.bmuschko.gradle.docker.tasks.image.Dockerfile
// 剩余代码保持不变

2. 统一docker插件版本 #

在主build.gradle的buildscript ext块中，将gradleDockerVersion改为子脚本需要的3.7.2版本，确保整个项目使用同一版本插件：

buildscript {
    ext {
        springBootVersion = '1.5.12.RELEASE'
        gradleDockerVersion = '3.7.2' // 统一为3.7.2版本
    }
    // 剩余buildscript内容不变
}

3. 规范脚本加载顺序（可选） #

建议将apply from: 'dockerapp.gradle'放在主脚本末尾，确保所有项目配置和变量初始化完成后再加载子脚本，避免潜在的变量未定义问题。

为什么这样修改有效？ #

• Gradle中重复引入不同版本的同一插件会导致类路径混乱，新版本类可能无法覆盖旧版本，或类加载器无法找到正确类；
• 统一将插件依赖放在主脚本buildscript中，保证整个项目只有一份插件依赖，版本一致，避免冲突；
• 子脚本仅负责定义任务和应用插件，符合Gradle脚本拆分的最佳实践。

现在重新执行./gradlew createAppImage，任务就能正常运行了。

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