运行Flutter Android应用触发java.lang.RuntimeException异常求助

问题现象 #

开发Flutter应用时，此前运行正常，从昨天开始在Android设备运行时出现Gradle错误，错误日志如下：

Launching lib\main.dart on Android SDK built for x86 in debug mode...
Running Gradle task 'assembleDebug'...
Exception in thread "main" java.lang.RuntimeException: Gradle distribution 'https://services.gradle.org/distributions/gradle-7.5-all.zip' does not contain any directories. Expected to find exactly 1 directory.
    at org.gradle.wrapper.Install.getAndVerifyDistributionRoot(Install.java:115)
    at org.gradle.wrapper.Install.access$000(Install.java:27)
    at org.gradle.wrapper.Install$1.call(Install.java:76)
    at org.gradle.wrapper.Install$1.call(Install.java:48)
    at org.gradle.wrapper.ExclusiveFileAccessManager.access(ExclusiveFileAccessManager.java:65)
    at org.gradle.wrapper.Install.createDist(Install.java:48)
    at org.gradle.wrapper.WrapperExecutor.execute(WrapperExecutor.java:128)
    at org.gradle.wrapper.GradleWrapperMain.main(GradleWrapperMain.java:61)
Exception: Gradle task assembleDebug failed with exit code 1

今天曾短暂恢复正常，但热重启后再次触发错误。尝试删除Android项目并通过flutter create my_project_name重新生成，问题依旧；实体Android设备运行也出现相同错误。

Flutter环境检测结果 #

[√] Flutter (Channel stable, 3.7.10, on Microsoft Windows [Version 10.0.18363.628], locale en-US)
[√] Windows Version (Installed version of Windows is version 10 or higher)
[√] Android toolchain - develop for Android devices (Android SDK version 33.0.2)
[√] Chrome - develop for the web
[√] Visual Studio - develop for Windows (Visual Studio Community 2022 17.5.3)
[√] Android Studio (version 2020.3)
[√] VS Code (version 1.77.3)
[√] Connected device (3 available)
[√] HTTP Host Availability

更新信息 #

所有Flutter项目均出现该问题，无法正常运行。

解决思路与方案 #

• 清理本地Gradle缓存：错误提示Gradle压缩包解压后无预期目录，大概率是本地缓存的Gradle包损坏。找到Windows默认Gradle缓存路径C:\Users\[你的用户名]\.gradle\wrapper\dists\gradle-7.5-all，删除该目录下所有文件，重新运行flutter run让系统重新下载解压Gradle包。
• 手动下载配置Gradle：直接下载gradle-7.5-all.zip并校验文件完整性，解压到Gradle缓存目录对应文件夹（保持原目录结构中的随机字符串文件夹），再重新运行项目。
• 排查网络问题：暂时关闭防火墙、代理软件，切换稳定网络后重新下载Gradle包，避免因网络中断导致包下载不完整。
• 调整Gradle版本：修改项目中android\gradle\wrapper\gradle-wrapper.properties的distributionUrl为其他稳定版本（如https://services.gradle.org/distributions/gradle-7.4-all.zip），重新运行项目。
• 清理Flutter缓存：执行flutter clean清理项目缓存，再运行flutter pub get，之后尝试重新启动项目。

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