Gradle如何让copySpec的from/include指定文件为必填项？

现有Gradle配置如下：

processResources {
    from ("/path/foo") {
        include 'conf.xml'   <--- 必填
    }
}

当前如果/path/foo目录不存在，或者该目录下的conf.xml文件找不到，构建过程不会报错。但实际需求是当这个文件缺失时，必须让Gradle构建直接失败——也就是/path/foo/conf.xml是构建的必需文件。

已知可以通过直接检查文件存在性的方式实现：

File file = new File("/path/foo/conf.xml")
if (!file.exists())
   ...

但这类必填文件的场景很多，几乎所有copySpec里的文件都是必填项而非可选，所以需要通用方案避免重复写检查逻辑。

方案1：给processResources加前置校验任务 #

把所有必填文件集中管理，构建前先校验，不通过直接失败：

task checkRequiredResources {
    doLast {
        // 列出所有需要校验的必填文件路径
        def requiredFiles = [
            "/path/foo/conf.xml",
            "/path/bar/config.properties" // 可添加更多
        ]
        
        requiredFiles.each { filePath ->
            def file = file(filePath)
            if (!file.exists()) {
                throw new GradleException("必填文件缺失：${file.absolutePath}")
            }
            if (!file.isFile()) {
                throw new GradleException("路径指向的不是文件：${file.absolutePath}")
            }
        }
    }
}

processResources.dependsOn checkRequiredResources

方案2：扩展CopySpec，用requiredInclude替代include #

直接在每个from块里声明必填，自动触发校验，更灵活：

// 扩展Gradle的CopySpec，新增requiredInclude方法
org.gradle.api.file.CopySpec.metaClass.requiredInclude = { String pattern ->
    include(pattern)
    // 绑定到所属任务，执行前校验匹配文件是否存在
    def task = delegate.getTask()
    task.doFirst {
        def matchingFiles = delegate.source.matching { include(pattern) }.files
        if (matchingFiles.isEmpty()) {
            throw new GradleException("必填文件匹配失败：pattern=${pattern}，来源路径=${delegate.source}")
        }
    }
}

// 实际使用时替换原来的include
processResources {
    from ("/path/foo") {
        requiredInclude 'conf.xml'
    }
    from ("/path/bar") {
        requiredInclude 'config.properties'
    }
}

方案3：全局配置所有Copy任务的必填校验 #

如果所有Copy类型任务（比如processResources、copy）都需要校验copySpec中的文件为必填，可以全局配置：

tasks.withType(Copy) { task ->
    task.doFirst {
        task.copySpecs.each { spec ->
            spec.includes.each { pattern ->
                def matchingFiles = spec.source.matching { include(pattern) }.files
                if (matchingFiles.isEmpty()) {
                    throw new GradleException("任务${task.name}中，必填文件匹配失败：pattern=${pattern}，来源路径=${spec.source}")
                }
            }
        }
    }
}

注意：这个方案会对所有Copy任务生效，如果有需要保留可选文件的任务，得单独做排除处理（比如给特定任务加onlyIf或跳过校验）。

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