React Native项目构建报错：Gradle升级后插件解析失败

背景 #

创建新React Native项目后，首次构建提示Gradle版本需至少8.7（当前为8.5），升级Gradle到8.7后，出现新错误：解析插件com.facebook.react.settings失败，报错java.io.UncheckedIOException: 无法将临时工作区移动到指定位置。

解决方案 #

1. 清理Gradle缓存 #

Gradle缓存冲突是这类问题的常见诱因，执行以下操作：

• 终端运行清理命令：

  ./gradlew cleanBuildCache
  

• 手动删除本地Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • macOS/Linux：~/.gradle/caches

2. 校验版本兼容性 #

React Native版本与Gradle版本存在对应适配关系，需确认匹配：

• 查看项目根目录package.json中的react-native版本
• 参考项目android/gradle/wrapper/gradle-wrapper.properties的注释说明，或android/build.gradle中的插件版本配置，确保Gradle 8.7与当前React Native版本兼容
• 若不兼容，可选择降级Gradle到项目支持的版本，或升级React Native至适配Gradle 8.7的版本

3. 修复目录权限问题 #

目录读写权限不足会导致临时文件移动失败：

• macOS/Linux用户执行权限修复命令：

  chmod -R 755 <你的项目根目录路径>
  chmod -R 755 ~/.gradle/caches
  

• Windows用户右键项目目录，进入「属性」-「安全」页签，确保当前用户拥有完全控制权限

4. 重新同步Gradle项目 #

完成上述操作后，重新同步项目：

• 在Android Studio中点击「File」-「Sync Project with Gradle Files」
• 或终端运行：

  ./gradlew sync
  

5. 检查插件配置正确性 #

打开android/build.gradle，确认com.facebook.react.settings插件引用正确：

plugins {
    id 'com.facebook.react.settings' version '<对应版本>' apply false
}

注意：不要随意修改插件版本号，保持与React Native版本匹配的默认配置即可。

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