安全升级Gradle应通过gradle-wrapper.properties修改distributionUrl指向新版本完整URL，同步配置IDEA中Gradle JVM为JDK 17+，保留toolchain声明以控制编译目标版本，执行./gradlew --stop清理旧Daemon。
直接替换 Gradle 二进制包（比如把 gradle-6.8 改成 gradle-8.10）是危险操作，IDEA 和命令行都可能因缓存、Daemon、wrapper 路径错位而报错。真正安全的做法是让 Gradle Wrapper 主导升级，再同步修正 JVM 和 IDE 配置。
用 gradle-wrapper.properties 锁定新版本，别碰本地 bin 目录
Gradle 的版本控制应由项目自身决定，不是靠手动替换 $GRADLE_HOME 下的文件夹。所有切换必须通过 gradle/wrapper/gradle-wrapper.properties 文件完成：
-
distributionUrl必须指向完整 URL，例如https\://services.gradle.org/distributions/gradle-8.10-bin.zip，不能写成gradle-8.10或本地路径 - 改完后不要手动删旧版目录；Gradle Daemon 会自动按需下载并缓存新版本到
~/.gradle/wrapper/dists/ - 如果公司内网无法访问外网仓库，必须提前把对应
-bin.zip包放到本地 HTTP 服务或文件共享路径，然后把distributionUrl改成file:///path/to/gradle-8.10-bin.zip
IDEA 里 Gradle JVM 必须匹配 wrapper 所需 JDK 版本
Gradle 8.x 要求最低 JDK 17 运行时，但你的项目代码仍可用 JDK 8 编译——这是两个独立层级。IDEA 里的 Gradle JVM 设置只影响 Gradle 进程本身，不影响 sourceCompatibility：
- 打开
Settings > Build > Build Tools > Gradle，把Gradle JVM设为 JDK 17+（Gradle 8.10 不支持 JDK 8 启动） - 同时检查
Project SDK和Project language level，它们控制代码编译目标，可单独设为 JDK 8（如老项目需要） - 如果插件
Gradle With Me 1.6.x已启用，它会在你打开项目时自动将Gradle JVM切到 wrapper 兼容的最低 JDK，无需手动干预
保留现有配置的关键：别动 build.gradle 里的 toolchain 声明
很多人升级 Gradle 后误删或注释掉 java { toolchain { languageVersion = JavaLanguageVersion.of(8) } }，结果导致编译产物字节码版本失控。toolchain 是 Gradle 6.7+ 引入的稳定机制，和 wrapper 版本无关，应始终保留：
- toolchain 指定的是编译器用哪个 JDK 编译源码，不是 Gradle 自己运行用哪个 JDK
- 即使你用 JDK 21 运行 Gradle，只要 toolchain 设为
JavaLanguageVersion.of(8)，生成的 class 就是 52.0 版本，兼容 JDK 8 JRE - 删除 toolchain 后，Gradle 默认使用
Gradle JVM对应的 JDK 编译，容易造成 “IDEA 里能跑，生产环境 ClassFormatError”
最容易被忽略的是 Daemon 状态：升级 wrapper 后，旧 Daemon 进程仍可能在后台用老 JDK 运行。执行 ./gradlew --stop 再重新 sync，比反复点 IDEA 的 “Reload project” 更可靠。
