构建Flutter应用时出现Daemon报错且每次报错信息不同如何解决

核心诱因 #

这类新建空项目仍复现、报错内容随机、曾在网络异常时出现的Flutter构建故障，核心是构建流程中依赖拉取失败、本地缓存损坏、进程访问被拦截三类问题导致。

排查解决步骤 #

• 首先执行flutter doctor -v，检查输出中所有标红的异常项，优先修复工具链、SDK权限类的提示问题。
• 清理全链路缓存：
  1. 进入项目根目录执行flutter clean，清除项目级临时构建产物
  2. 执行flutter pub cache clean，清除Flutter全局依赖缓存
  3. 删除本地Gradle全局缓存目录，Windows默认路径为C:\Users\你的用户名\.gradle\caches，macOS/Linux默认路径为~/.gradle/caches
  4. 执行flutter shutdown关闭Flutter后台守护进程，再重新尝试运行项目
• 调整镜像源配置：
  1. 检查环境变量中的Flutter/Pub镜像配置，可切换为阿里云、清华大学等稳定公共镜像，避免当前所用镜像节点异常
  2. 修改项目android/build.gradle文件，将仓库配置替换为国内稳定镜像，示例配置如下：

  buildscript {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
      }
  }
  allprojects {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
      }
  }
  

• 检查权限与拦截规则：
  1. 确认Flutter SDK、项目文件都存放在普通非受保护目录，不要放在C盘Program Files、Windows等需要管理员权限的目录下
  2. 临时关闭杀毒软件、系统防火墙，再尝试构建，排除安全软件拦截构建进程的网络请求、文件读写操作的可能
• 若以上步骤均无效，可重新下载稳定版Flutter SDK，替换原有本地SDK文件后再尝试构建。

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