Flutter项目构建失败：磁盘空间不足引发多类报错，请求协助解决

错误核心原因 #

磁盘空间不足，导致两个关键环节失败：

1. Gradle无法完成io.agora.rtc:full-sdk:4.2.1的AAR文件转换，触发:agora_rtc_engine:generateDebugRFile任务失败
2. Dart编译器无法写入临时文件app.dill，导致编译器意外退出

完整错误日志 #

FAILURE: 构建过程中出现异常导致失败。

• 出错原因：
  任务 ':agora_rtc_engine:generateDebugRFile' 执行失败。

无法为配置 ':agora_rtc_engine:debugCompileClasspath' 解析所有文件。
无法转换full-sdk-4.2.1.aar（io.agora.rtc:full-sdk:4.2.1）以匹配属性 {artifactType=android-symbol-with-package-name, org.gradle.category=library, org.gradle.libraryelements=jar, org.gradle.status=release, org.gradle.usage=java-api}。

ExtractAarTransform执行失败：C:\Users\sahir.gradle\caches\transforms-3\d7b9b9781f6f39ebf93efcf97e80e768\transformed\jetified-full-sdk-4.2.1.aar。
磁盘空间不足

BUILD FAILED in 5s
未处理异常：
FileSystemException: writeFrom操作失败，路径 = 'C:\Users\sahir\AppData\Local\Temp\flutter_tools.c09ef4ad\flutter_tool.a166bfa9\app.dill'（系统错误：磁盘空间不足。错误号 = 112）
#0 _checkForErrorResponse (dart:io/common.dart:55)
#1 _RandomAccessFile.writeFrom. (dart:io/file_impl.dart:885)
#2 _FileStreamConsumer.addStream. (dart:io/file_impl.dart:218)

Dart编译器意外退出。
Error: Gradle任务assembleDebug执行失败，退出码为1

解决步骤 #

• 释放磁盘空间
  • 删除C盘冗余文件（如下载的安装包、过期文档、无用软件）
  • 通过Windows「存储」功能一键清理系统临时文件
• 清理Gradle缓存
  • 删除路径 C:\Users\sahir\.gradle\caches 下的所有文件，Gradle会在下次构建时重新下载所需依赖
• 清理Flutter临时文件
  • 删除C:\Users\sahir\AppData\Local\Temp下所有flutter_tools_开头的文件夹
• 转移Gradle缓存目录（可选）
  • 在项目的gradle.properties文件中添加配置：gradle.user.home=D:\Your\Custom\Gradle\Cache\Path，将缓存转移到剩余空间充足的磁盘
• 重新构建项目
  • 执行命令：

    flutter clean
    flutter run
    

内容的提问来源于stack exchange，提问作者Muhammad Irfan Khan