运行首个Flutter默认项目报错：mainMergedManifest指定的xml文件不存在

报错解决方案 #

该错误是Gradle构建Android应用时，无法找到合并生成的主清单文件导致，可按以下步骤逐一排查解决：

• 第一步：清理项目本地缓存
  打开终端进入项目根目录，依次执行以下命令：

  flutter clean
  flutter pub get
  

  执行完成后重新尝试运行项目。
• 第二步：修复路径特殊字符问题
  当前项目路径包含空格（Program Future目录名存在空格），Android Gradle构建对包含空格、中文、特殊符号的路径兼容性极差，是该类报错的高发原因。请将Flutter SDK安装路径、项目存放路径都修改为纯英文、无空格、无特殊符号的格式，例如调整为E:\Program_Future\Flutter\ 这类格式后再重新构建。
• 第三步：适配Gradle版本与镜像源
  如果路径调整后仍报错，需要检查Android端的构建配置：
  1. 打开项目android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl对应的Gradle版本和你的Flutter版本适配，Flutter 3.0+推荐使用gradle-7.5-all.zip及以上稳定版本。
  2. 打开项目android/build.gradle文件，确认com.android.tools.build:gradle的版本和Gradle版本匹配，例如Gradle 7.5对应AGP版本为7.4.x即可。
  3. 替换build.gradle文件中所有repositories块的官方镜像源为国内镜像，避免依赖拉取失败导致构建中断。
• 第四步：清理全局Gradle缓存
  以上操作都完成后仍报错的话，删除本地全局Gradle缓存目录（默认路径为C:\Users\你的用户名\.gradle\caches），之后重新运行项目，等待Gradle重新拉取全部依赖即可。

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