Debian系统Flutter项目Gradle构建报错：找不到org.gradle.wrapper.GradleWrapperMain

方法1：修复项目Gradle Wrapper文件 #

项目的Gradle Wrapper文件可能损坏或缺失，按以下步骤处理：

• 进入项目的android/gradle/wrapper目录，检查是否存在gradle-wrapper.jar和gradle-wrapper.properties。若缺失，可通过以下方式重新生成：
  1. 删除项目的android/gradle/wrapper文件夹
  2. 在项目根目录执行命令：

     flutter create --platforms android .
     

     该命令会重新生成Android相关配置，不会覆盖现有业务代码
• 打开gradle-wrapper.properties，确认distributionUrl路径正确，示例：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
  

  确保版本与本地Gradle兼容，或直接使用Flutter默认推荐版本

方法2：配置本地Gradle路径 #

既然已单独下载Gradle，可指定项目使用本地安装包：

• 打开Android Studio，依次进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 在Gradle user home中设置本地Gradle的安装路径（例如/opt/gradle/gradle-7.5）
• 选择Use Gradle from: 为Specified location，并指向本地Gradle目录
• 点击Apply保存后，执行flutter clean，再重新尝试构建命令

方法3：修复Debian系统下的文件权限 #

Linux系统的权限限制可能导致Gradle无法读取Wrapper文件：

• 给项目Android目录及子目录设置正确权限：

  chmod -R 755 你的Flutter项目路径/android/
  

• 单独确保gradle-wrapper.jar的可读权限：

  chmod 644 你的Flutter项目路径/android/gradle/wrapper/gradle-wrapper.jar
  

方法4：清理缓存后重新构建 #

• 执行flutter clean清理Flutter缓存
• 删除项目的android/.gradle文件夹
• 重新运行flutter build apk或flutter build appbundle

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