Android Studio复制Flutter项目到D盘后构建报错的解决方法

问题根源 #

项目从C盘复制到D盘后，本地依赖缓存（如Flutter的.dart_tool、Android的.gradle等）中残留了原C盘的路径关联，导致构建时路径不匹配，触发任务创建失败。

修复步骤 #

• 删除项目本地缓存目录
  进入D盘的项目根目录，手动删除以下文件夹：

  • .dart_tool
  • .gradle
  • build
  • 若包含iOS模块，删除ios/Pods
  • 进入android子目录，删除.gradle文件夹

• 重新拉取依赖并清理构建缓存
  在项目根目录打开终端，依次执行：

  flutter clean
  flutter pub get
  

  这两步会彻底清除旧的路径关联缓存，重新生成适配当前D盘路径的依赖配置。

• 强制刷新Android构建依赖
  如果仍有Android相关任务报错，进入项目的android目录，执行：

  ./gradlew clean
  ./gradlew build --refresh-dependencies
  

  让Gradle完全刷新依赖，重新生成构建任务配置。

• 检查PUB_CACHE环境变量（可选）
  查看系统环境变量里的PUB_CACHE是否硬指定了C盘路径，如果有，改成通用路径（比如用户目录下的.pub-cache，或者D盘的自定义缓存目录），避免路径绑定。

• 重启IDE后重试
  完成以上操作后，关闭当前IDE，重新打开D盘的项目，再尝试构建运行。

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