新创建的React Native项目无法在Android模拟器启动求助

用npx react-native@latest init创建全新React Native模板项目，未做任何修改直接运行时，出现Gradle构建失败错误，完整报错信息如下：

error Failed to install the app. Command failed with exit code 1: gradlew.bat app:installDebug -PreactNativeDevServerPort=8081
FAILURE: Build failed with an exception.

* What went wrong:
java.io.UncheckedIOException: Could not move temporary workspace (C:\Users\Abdul\Documents\Personal Instagram Clone\Frontend\instagramclone\android\.gradle\8.6\dependencies-accessors\423f0288fa7dffe069445ffa4b72952b4629a15a-8246c9d0-6550-4e4b-9954-43caf3cc7c98) to immutable location (C:\Users\Abdul\Documents\Personal Instagram Clone\Frontend\instagramclone\android\.gradle\8.6\dependencies-accessors\423f0288fa7dffe069445ffa4b72952b4629a15a)
> Could not move temporary workspace (C:\Users\Abdul\Documents\Personal Instagram Clone\Frontend\instagramclone\android\.gradle\8.6\dependencies-accessors\423f0288fa7dffe069445ffa4b72952b4629a15a-8246c9d0-6550-4e4b-9954-43caf3cc7c98) to immutable location (C:\Users\Abdul\Documents\Personal Instagram Clone\Frontend\instagramclone\android\.gradle\8.6\dependencies-accessors\423f0288fa7dffe069445ffa4b72952b4629a15a)

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.

BUILD FAILED in 4s.

解决方案 #

• 清理项目Gradle缓存

  1. 关闭所有IDE、终端，确保没有进程占用Gradle相关文件
  2. 进入项目的android\.gradle\8.6\dependencies-accessors目录，删除报错中提到的两个文件夹
  3. 回到项目根目录，重新执行npx react-native run-android

• 释放文件占用

  • 临时关闭杀毒软件/防火墙的实时防护
  • 不要打开android\.gradle目录下的任何文件
  • 用任务管理器结束所有Java、Gradle相关进程，再重新构建

• 重置项目依赖与Gradle配置

  1. 删除项目根目录的node_modules文件夹和package-lock.json（或yarn.lock）
  2. 执行npm install（或yarn）重装依赖
  3. 进入android目录，执行gradlew.bat clean（Windows系统）或./gradlew clean（Mac/Linux系统）
  4. 回到根目录重新运行项目

• 缩短项目路径
  Windows系统有文件路径长度限制，你的项目路径过长可能导致文件操作失败。将项目移动到更短的路径下，比如C:\code\instagramclone，再重新尝试运行。

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