Flutter运行报错：Gradle任务assembleDebug失败，无法使用模拟器

针对你遇到的Gradle构建错误：

Error: Could not find or load main class org.gradle.wrapper.GradleWrapperMain
Caused by: java.lang.ClassNotFoundException: org.gradle.wrapper.GradleWrapperMain
Exception: Gradle task assembleDebug failed with exit code 1

可以按以下步骤逐一排查解决：

• 检查Gradle Wrapper文件完整性
  项目根目录下的gradle/wrapper文件夹必须包含gradle-wrapper.jar和gradle-wrapper.properties两个文件。如果缺失，从一个正常的同版本Flutter项目中复制该文件夹到你的项目里，或者通过flutter create temp_project生成临时项目，再复制对应文件。

• 重新生成Gradle Wrapper
  在项目根目录的终端执行命令：

  • Linux/macOS: ./gradlew wrapper --gradle-version <指定版本>
  • Windows: gradlew.bat wrapper --gradle-version <指定版本>
    版本号可查看gradle-wrapper.properties中distributionUrl对应的版本（比如7.4）。

• 清理缓存并重建项目

  1. 执行flutter clean清理Flutter缓存
  2. 删除项目根目录和android目录下的.gradle文件夹
  3. 运行flutter pub get重新拉取依赖
  4. 再次尝试flutter run

• 验证Java环境配置
  确保JAVA_HOME环境变量指向正确的JDK（推荐JDK 11或17，适配多数Gradle版本），终端执行java -version和javac -version确认版本一致且正常运行。

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