Gradle dist任务未复制runtimeClasspath中的Zip文件问题

问题根源 #

你遇到的核心问题是：当使用from(configurations.runtimeClasspath)作为Copy任务的源时，Gradle默认会展开归档文件（如Zip、Jar）的内容，而非复制归档文件本身。这就是为什么打印的文件列表里包含Zip，但目标目录中找不到原文件——Gradle已经将Zip内的内容展开复制到了目标目录，原Zip文件不会被保留。

修复方案 #

如果你需要复制依赖的原文件（包括Zip、Jar等归档文件），而非展开它们的内容，需要直接引用配置的files集合，而非配置本身。修改后的任务代码如下：

tasks.register<Copy>("dist") {
    dependsOn(tasks.jar)
    into("$buildDir/dist")

    // 直接引用配置的文件集合，复制原文件而非展开内容
    from(provider { configurations.runtimeClasspath.get().files })
    from(tasks.jar)

    // 在执行阶段打印要复制的文件，确保与实际执行逻辑一致
    doFirst {
        println("copyDependencies:\n  ${configurations.runtimeClasspath.get().files.joinToString("\n  ") { it.absolutePath }}\n  ->\n  $buildDir/dist")
    }

    // 可选：验证复制结果，快速定位缺失文件
    doLast {
        val distDir = file("$buildDir/dist")
        val missingFiles = configurations.runtimeClasspath.get().files.filter { !distDir.resolve(it.name).exists() }
        if (missingFiles.isNotEmpty()) {
            println("Missing files in dist: ${missingFiles.joinToString { it.name }}")
        } else {
            println("All files copied successfully")
        }
    }
}

关键修改说明 #

1. 改用provider惰性获取文件：确保在任务执行阶段才解析runtimeClasspath的文件集合，避免配置阶段与执行阶段的文件状态不一致。
2. 直接引用files集合：configurations.runtimeClasspath.get().files返回的是依赖的原始文件（包括Zip、Jar），而非归档内的内容，Gradle会直接复制这些文件本身。
3. 将日志移至doFirst：原代码中的println在配置阶段执行，可能与执行阶段的实际文件列表存在差异，移至doFirst后能准确打印执行时要复制的文件。

额外排查点 #

如果修改后问题仍存在，可以检查以下内容：

• 全局Copy规则：确认根项目中没有定义全局排除规则，比如tasks.withType<Copy> { exclude("*.zip") }，这类规则会自动作用于所有Copy任务。
• 依赖任务依赖：如果Zip文件来自其他子项目的输出，需要显式依赖该子项目的构建任务，确保Zip文件已生成。

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