Gradle Exec任务依赖扩展属性实现懒配置时的缺失值异常问题咨询

问题根源 #

出现MissingValueException的核心原因，是复现代码在任务配置块中对扩展的Property调用了.get()同步取值方法——这个操作会强制打断Gradle原生的懒求值链路，在任务注册阶段就触发属性值查询，此时扩展属性还未完成赋值，自然会抛出空值异常。

官方规范实现方式 #

完全可以基于Gradle原生的Provider懒绑定能力，实现Exec任务和扩展属性的解耦绑定，不需要提前同步查询属性值：

• Exec任务的commandLine方法本身原生支持接收Provider<String>类型的入参，直接传入扩展定义的Property实例，就会自动建立两个属性之间的关联绑定关系
• 这种绑定方式下，任务注册阶段不会触发任何属性值查询，仅完成关联关系的记录，完全符合任务配置规避的设计要求

修改后的核心代码 #

abstract class ConfigExtension() {
    abstract val command: Property<String>
}

class MyGradlePlugin : Plugin<Project> {
    override fun apply(project: Project) {
        val myConfig = project.extensions.create(
            "myConfig",
            ConfigExtension::class.java
        )

        project.tasks.register(
            "myTask",
            Exec::class.java
        ) {
            // 直接传入Provider实例，不要调用.get()提前取值
            it.commandLine(myConfig.command)
        }
    }
}

扩展使用说明 #

• 后续不管在构建脚本的哪个阶段给myConfig.command赋值，Gradle都会在任务真正进入执行阶段、需要解析命令行参数时，才会统一读取关联的属性值，从根源上避免任务创建阶段的空值异常
• 如果需要对命令参数做简单的格式转换、字符串拼接，可以直接使用Provider自带的map()懒转换方法，整个过程依然保持懒执行，不会破坏懒求值机制，示例：

  // 给原始命令加上shell执行的前置参数，依然是懒执行，不会提前取值
  it.commandLine(myConfig.command.map { originalCmd -> "sh -c $originalCmd" })
  

• 修改后的逻辑完全适配原有测试用例：任务注册阶段不会读取扩展属性的值，就算测试时未给扩展属性赋值，也不会抛出空值异常，可以正常通过tasks.findByName("myTask")校验任务注册状态

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