Debian系统Flutter项目GradleWrapperMain类加载失败求助

Debian系统下的Flutter项目，已配备完整Gradle Wrapper文件且手动下载了Gradle 8.5，但运行时仍抛出以下错误：

Error: Could not find or load main class org.gradle.wrapper.GradleWrapperMain
Caused by: java.lang.ClassNotFoundException: org.gradle.wrapper.GradleWrapperMain

项目配置详情 #

• 已存在gradle-wrapper.properties、gradlew、gradlew.bat等Gradle Wrapper核心文件
• 手动下载了Gradle 8.5版本
• flutter doctor检测无异常
• 已执行chmod +x gradlew确保脚本可执行权限正常

已尝试的排查步骤 #

• 执行./gradlew clean清理Gradle缓存
• 手动下载Gradle 8.5并更新gradle-wrapper.properties配置
• 检查Java版本与Gradle 8.5的兼容性
• 确认防火墙及杀毒软件未拦截Gradle联网请求
• 通过flutter channel stable和flutter upgrade升级Flutter至稳定版最新版
• 删除项目内gradle目录及gradlew文件后重新运行flutter doctor

额外排查与解决建议 #

1. 检查gradle-wrapper.jar完整性 #

项目根目录下的gradle/wrapper/gradle-wrapper.jar文件可能损坏或缺失，直接从Gradle 8.5官方压缩包中提取对应文件替换到该路径，确保文件大小与官方一致。

2. 强制指定本地Gradle路径 #

在项目的gradle.properties文件中添加以下配置，强制使用本地已下载的Gradle版本：

org.gradle.java.home=/path/to/your/jdk
gradle.user.home=/path/to/your/local/gradle-8.5

替换路径为你本地JDK和Gradle的实际安装路径。

3. 验证Java环境变量 #

执行以下命令确认Java环境配置：

echo $JAVA_HOME
java -version

Gradle 8.5要求JDK 11及以上版本，需确保当前使用的JDK版本符合要求，且无多个JDK版本冲突。

4. 清理全局Gradle缓存 #

删除用户目录下的全局Gradle缓存文件夹，重新初始化缓存：

rm -rf ~/.gradle

之后重新运行项目，让Gradle重新下载并生成必要文件。

5. 重新生成Gradle Wrapper #

进入项目的android目录，执行以下命令重新生成完整的Gradle Wrapper文件：

gradle wrapper --gradle-version 8.5

覆盖现有Wrapper文件后，再尝试运行项目。

内容的提问来源于stack exchange，提问作者med amine ab