GitHub Actions中Gradle Wrapper报错：'validateDistributionUrl'未配置值

问题原因 #

Gradle 8.6对Wrapper任务新增了validateDistributionUrl属性的强制校验要求，而你项目中目标的Gradle 5.6.4版本不存在这个属性。当GitHub Actions自动升级到Gradle 8.6后，执行旧的Wrapper任务配置时，就会触发该属性未配置的错误。

解决方案 #

方案1：显式配置validateDistributionUrl属性

修改你的bootstrap.gradle文件中的downloadWrapper任务，添加该属性的配置：

task downloadWrapper(type: Wrapper) {
    gradleVersion = '5.6.4'
    // 显式设置分发URL验证开关
    validateDistributionUrl = false // 若需验证URL有效性可设为true
}

• 设置为false会跳过对Gradle分发包URL的验证，适配旧版本Gradle的下载场景；
• 设置为true则要求URL必须是有效的官方地址，适合确保分发包来源可靠的场景。

方案2：在GitHub Actions中指定使用Gradle 8.5执行bootstrap步骤

既然本地用Gradle 8.5可正常构建，在GitHub Actions里强制使用该版本运行bootstrap命令即可规避兼容性问题。示例配置如下：

- name: 配置Gradle 8.5环境
  uses: gradle/actions/setup-gradle@v3
  with:
    gradle-version: '8.5'
- name: 执行bootstrap构建
  run: gradle -b bootstrap.gradle

方案3：升级目标Gradle版本（可选）

如果项目对旧Gradle版本没有强依赖，可以将Wrapper的目标版本升级到8.5或更高兼容版本，此时Gradle会自动处理validateDistributionUrl的默认配置，无需手动添加。但此方案需要提前评估项目依赖的兼容性。

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