必须使用与distributionUrl完全匹配的同源、同版本、同后缀（如-all）的SHA256校验和，否则Gradle Wrapper校验失败会直接中断构建；常见错误包括混用bin/all校验和、镜像源不一致、复制时带空格或换行。

直接改 distributionSha256Sum 就行，但必须用对应 all 包的正确 SHA256 值，不能随便复制或留空。

为什么校验和会不匹配

Gradle Wrapper 启动时会先下载 distributionUrl 指向的 zip 包，再用 distributionSha256Sum 校验完整性。一旦值对不上，就会报错：Checksum validation failed 或类似提示。

常见原因包括：

Gradle 9.8.0

下载

• 手动改了 distributionUrl 但没同步更新 distributionSha256Sum
• 从镜像站下载的是 bin 包，却粘贴了 all 包的校验和（或反过来）
• 镜像站提供的 .sha256 文件本身被缓存或 CDN 返回了旧内容
• 复制时多了一个空格、换行，或用了中文标点

怎么拿到正确的校验和

必须严格按“同源、同版本、同后缀”三原则获取：

• 去你正在用的镜像站（比如 https://mirrors.huaweicloud.com/gradle/），找到和 distributionUrl 完全一致的 zip 文件名（例如 gradle-9.3.1-all.zip）
• 点击它旁边的 gradle-9.3.1-all.zip.sha256 链接（不是 .sha256.txt 或其他变体）
• 用浏览器直接打开该文件，全选 → 复制 → 粘贴到 distributionSha256Sum= 后面（不要加引号，不要换行）
• 确认 distributionUrl 和 .sha256 文件来自同一镜像路径，避免混用腾讯云 URL + 华为云校验和

校验和为空或填错会怎样

Gradle 不会跳过校验，也不会自动补全：

• 留空或填错：构建直接失败，提示 Invalid checksum 或 Failed to validate downloaded Gradle distribution
• 填了但末尾有空格：同样失败，错误信息可能不明显，需检查日志里实际读取的值
• 用了 bin 包的校验和去配 all 包：下载成功但校验失败，因为两个 zip 内容完全不同

最容易被忽略的是：某些镜像站把 .sha256 文件放在二级目录或重定向了，直接点链接看不到纯文本——这时候建议右键“另存为”，再用记事本打开确认内容是否只有一行 64 位十六进制字符串。