执行npm run android时遇Gradle缓存移动失败问题求助

错误核心信息 #

执行npm run android时出现如下构建失败错误：

info Installing the app...
> Task :app:checkDebugAarMetadata FAILED
9 actionable tasks: 4 executed, 5 up-to-date

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:checkDebugAarMetadata'.
> A build operation failed.
      Could not move temporary workspace (C:\Users\piyus\.gradle\caches\transforms-4\716f968cc1e5225035406d1e56ec874f-06068847-f68e-4407-947b-c375036a555c) to immutable location (C:\Users\piyus\.gradle\caches\transforms-4\716f968cc1e5225035406d1e56ec874f)
   > Could not move temporary workspace (C:\Users\piyus\.gradle\caches\transforms-4\716f968cc1e5225035406d1e56ec874f-06068847-f68e-4407-947b-c375036a555c) to immutable location (C:\Users\piyus\.gradle\caches\transforms-4\716f968cc1e5225035406d1e56ec874f)

BUILD FAILED in 1m 35s
error Failed to install the app. Command failed with exit code 1: gradlew.bat app:installDebug -PreactNativeDevServerPort=8081

解决方案 #

• 清理Gradle缓存并重建

  1. 关闭VS Code及所有Android相关后台进程（如Android Studio、Java进程）
  2. 删除Gradle缓存目录：C:\Users\piyus\.gradle\caches
  3. 进入项目的android目录，执行命令：gradlew clean
  4. 返回项目根目录，重新运行npm run android

• 检查文件权限
  右键C:\Users\piyus\.gradle文件夹，选择「属性」→「安全」，确保当前用户拥有完全控制权限，若权限不足则添加对应权限。

• 终止占用缓存的进程
  打开任务管理器，结束所有java.exe、gradle.exe相关进程；也可通过命令行强制终止：

  taskkill /f /im java.exe
  taskkill /f /im gradle.exe
  

• 更换Gradle缓存目录（备选方案）
  在项目的gradle.properties文件中添加自定义缓存路径（确保路径存在且有权限）：

  gradle.user.home=D:\YourCustomGradleCachePath
  

  保存后重新运行构建命令。

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