删除/Users/user/.gradle/caches后Flutter运行失败，求解决方案

问题重现 #

删除/Users/user/.gradle/caches文件夹后，运行Flutter应用时出现以下错误：

* What went wrong:
Execution failed for task ':app:checkDebugAarMetadata'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction
   > /Users/user/.gradle/caches/transforms-3/2f2881f4cceb526aca8e817e92e637d5/transformed/jetified-firebase-functions-20.4.0/META-INF/com/android/build/gradle/aar-metadata.properties (No such file or directory)

已尝试flutter clean、flutter pub get但无效，可按以下步骤解决：

• 强制Gradle重新下载并重建依赖缓存
  进入项目的android目录，执行以下命令：

  ./gradlew cleanBuildCache
  ./gradlew build --refresh-dependencies
  

  这会清除本地Build Cache，并强制Gradle重新拉取所有依赖，修复缺失的元数据文件。

• 检查Firebase依赖版本一致性
  打开项目根目录的pubspec.yaml，确保所有Firebase相关依赖（如firebase_core、firebase_functions）使用兼容的版本。建议统一使用最新稳定版，避免因版本不匹配导致的依赖解析异常。

• 清除项目本地Gradle缓存
  删除项目android目录下的.gradle文件夹，回到项目根目录执行：

  flutter pub get
  

  再重新运行应用，让Gradle重新初始化项目依赖。

• 验证AGP与Gradle版本兼容性
  打开android/build.gradle（根级文件），检查com.android.tools.build:gradle的版本，再打开android/gradle/wrapper/gradle-wrapper.properties查看Gradle版本，确保两者版本匹配（例如AGP 7.4.x对应Gradle 7.5+）。版本不兼容会导致依赖处理流程出错。

内容的提问来源于stack exchange，提问作者Go-At Solutions