React Native 0.75.2项目Android构建失败问题求助

问题描述 #

创建React Native 0.75.2项目，使用npx @react-native-community/cli init newapp初始化，执行yarn start后运行yarn android，系统按配置下载Gradle 8.8后出现构建错误：

FAILURE: Build failed with an exception.

* Where:
Settings file 'C:\Users\JOHN\Desktop\react\newapp\android\settings.gradle' line: 2

* What went wrong:
Error resolving plugin [id: 'com.facebook.react.settings']
> java.io.UncheckedIOException: Could not move temporary workspace (C:\Users\JOHN\Desktop\react\newapp\android\.gradle\8.8\dependencies-accessors\569c8b261a8a714d7731d5f568e0e5c05babae10-d380c3b5-5c8f-4497-a8a6-a9f1675d5c36) to immutable location (C:\Users\JOHN\Desktop\react\newapp\android\.gradle\8.8\dependencies-accessors\569c8b261a8a714d7731d5f568e0e5c05babae10) 

运行npx react-native doctor显示Android SDK未找到（要求版本34.0.0），其余环境正常。此前使用RN 0.69无异常。react-native info输出如下：

System:
  OS: Windows 10 10.0.19045
  CPU: (12) x64 12th Gen Intel(R) Core(TM) i7-1255U
  Memory: 16.19 GB / 31.75 GB
Binaries:
  Node:
    version: 20.10.0
    path: C:\Program Files\nodejs\node.EXE
  Yarn:
    version: 3.6.4
    path: ~\AppData\Roaming\npm\yarn.CMD
  npm:
    version: 10.2.3
    path: C:\Program Files\nodejs\npm.CMD
  Watchman: Not Found
SDKs:
  Android SDK: Not Found
  Windows SDK: Not Found
IDEs:
  Android Studio: AI-231.9392.1.2311.11255304
  Visual Studio: Not Found
Languages:
  Java: 17.0.9
  Ruby: Not Found
npmPackages:
  "@react-native-community/cli": Not Found
  react:
    installed: 18.3.1
    wanted: 18.3.1
  react-native:
    installed: 0.75.2
    wanted: 0.75.2
  react-native-windows: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: false
iOS:
  hermesEnabled: Not found
  newArchEnabled: Not found

已尝试降级Gradle到8.5并执行gradlew clean，问题仍未解决。

解决方案 #

1. 修复Android SDK未识别问题 #

RN 0.75.2要求Android SDK 34.0.0，先确保SDK配置正确：

• 检查系统环境变量：确认ANDROID_HOME或ANDROID_SDK_ROOT指向SDK安装路径（默认是C:\Users\你的用户名\AppData\Local\Android\Sdk）
• 将SDK的platform-tools和tools\bin目录添加到系统PATH中
• 打开Android Studio，进入Settings > Appearance & Behavior > System Settings > Android SDK，安装：
  • Android 14 (API 34)的SDK Platform
  • SDK Build-Tools 34.0.0
  • NDK (Side by side) 25.2.9519653（RN 0.75推荐版本）
• 重启终端，运行npx react-native doctor确认SDK被检测到

2. 解决Gradle文件移动错误 #

该错误通常由文件锁定或缓存损坏导致，按以下步骤操作：

• 关闭所有占用项目文件夹的程序（Android Studio、VS Code、终端等）
• 删除项目内的Gradle缓存和构建文件：

  rmdir /s /q android\.gradle
  rmdir /s /q android\build
  

• 可选：删除全局Gradle缓存（会清除所有项目的Gradle缓存，需重新下载依赖）：

  rmdir /s /q C:\Users\你的用户名\.gradle\caches
  

• 以管理员身份打开终端，进入项目根目录，重新运行：

  yarn android
  

• 如果仍报错，尝试修改Gradle缓存路径到非系统盘，在项目根目录的gradle.properties中添加：

  gradle.user.home=D:\GradleCache
  

3. 切换Yarn版本（可选） #

Yarn 3.x与RN 0.75可能存在兼容性问题，尝试切换到Yarn 1.x：

yarn set version 1.22.22
yarn install
yarn android

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