为什么我Gradle自定义任务的optional可选输入配置不生效？

问题根因 #

你对optional()方法的作用理解没有偏差，它的设计目标就是标记任务输入为可选，对应文件不存在时也不阻断任务执行。你遇到的报错是Gradle单文件输入的解析逻辑版本兼容问题：当直接向inputs.file()传入固定路径字符串时，部分Gradle版本（包括你使用的6.x、7.x版本）会优先触发文件存在性校验，优先级高于optional()标记的规则，所以仍然会抛出不存在的错误。

正确写法 #

方案1：配合Provider延迟路径解析 #

用Provider包裹文件获取逻辑，让Gradle延迟到执行前的最后一步再解析路径，此时optional()标记会正常生效，同时还能保留增量构建的能力：

task myTask {
   inputs.file(provider { file("input.txt") }).optional()
   doLast { println "input.txt exists = " + file("input.txt").exists() }
}

方案2：用多文件输入简化配置 #

inputs.files()（多文件输入）天然允许输入集合为空，就算指定路径的文件不存在也不会触发校验，写法更简洁，同样支持增量构建：

task myTask {
   inputs.files("input.txt")
   doLast { println "input.txt exists = " + file("input.txt").exists() }
}

额外说明 #

你之前用if (file("input.txt").exists())包裹逻辑的写法虽然能运行，但不会被Gradle的增量构建机制识别：如果后续input.txt被新增、修改，Gradle无法自动感知到变更触发任务重跑，会出现构建结果不符合预期的问题。而上面两种声明式的输入配置可以完美适配增量构建逻辑，更符合Gradle的最佳实践。

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