React Native裸项目构建失败：无法创建kotlin-gradle-plugin Jar文件

问题描述 #

原本用Expo Go运行正常的React Native项目，执行expo eject转为裸项目后，运行yarn android构建失败，报错如下：

FAILURE: Build failed with an exception.

* What went wrong:
A problem occurred configuring project ':react-native-gradle-plugin'.
> java.util.concurrent.ExecutionException: org.gradle.api.GradleException: Failed to create Jar file C:\Users\User\.gradle\caches\jars-9\196b729407d7fbb2907378f4b4c34b5a\kotlin-gradle-plugin-1.6.10.jar.

* 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 

已尝试清理Gradle缓存和构建文件夹，问题仍存在。

解决思路与步骤 #

• 检查并调整Kotlin版本兼容性
  打开项目根目录的android/build.gradle（项目级配置文件），找到ext.kotlin_version字段。若当前为1.6.10，尝试升级到与你的React Native版本兼容的稳定版（比如RN 0.7x对应Kotlin 1.8.20），修改后保存，重新执行构建命令。

• 手动删除损坏的缓存文件
  直接定位到错误提示中的缓存路径C:\Users\User\.gradle\caches\jars-9\196b729407d7fbb2907378f4b4c34b5a\，删除整个该文件夹，再运行yarn android让Gradle重新下载依赖缓存。

• 匹配Gradle与Kotlin版本
  打开android/gradle/wrapper/gradle-wrapper.properties，查看distributionUrl中的Gradle版本。Kotlin 1.6.10需要Gradle 7.3及以上版本，若你的Gradle版本过低，将其升级到对应兼容版本后重新构建。

• 修复Gradle文件夹权限
  右键C:\Users\User\.gradle文件夹，选择「属性」-「安全」，检查当前用户是否拥有读写权限。若权限不足，添加读写权限并应用设置，再重新执行构建。

• 彻底重置构建环境

  1. 进入android目录：cd android
  2. 执行Gradle缓存清理：gradlew cleanBuildCache（Windows系统）
  3. 删除android/app/build和android/build文件夹
  4. 回到项目根目录执行yarn install，再重新运行yarn android

• 验证react-native-gradle-plugin版本
  打开项目级android/build.gradle，查看buildscript.dependencies中的react-native-gradle-plugin版本，确保其与项目的React Native版本完全一致（比如RN 0.69.x对应plugin版本0.69.x），不一致则修改后同步配置。

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