React Native创建项目遇Gradle版本问题：java.io.UncheckedIOException报错

针对Gradle 8.8的插件解析错误（文件移动失败） #

• 清理Gradle本地缓存
  删除项目android目录下的.gradle/8.8/dependencies-accessors目录，或者直接删除整个.gradle文件夹，然后执行命令：

  ./gradlew clean
  ./gradlew assembleDebug
  

• 检查项目路径合法性
  确认项目路径无空格、中文或特殊字符，报错中路径C:\Proje\AwesomeProject疑似笔误（应为C:\Project\AwesomeProject），路径错误会导致Gradle无法正常读写文件。

针对降级到Gradle 8.4/8.6后的Kotlin错误 #

• 同步Kotlin版本与React Native要求
  在项目级android/build.gradle中指定兼容的Kotlin版本，以RN 0.73+为例：

  buildscript {
      ext {
          kotlinVersion = "1.9.20"
          // 保留其他原有配置
      }
      dependencies {
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
          // 保留其他原有依赖
      }
  }
  

• 确认gradle-wrapper配置正确
  修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl，对应版本：

  # Gradle 8.4
  distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
  # Gradle 8.6
  distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-all.zip
  

通用建议 #

优先使用React Native官方推荐的Gradle与Kotlin版本组合，不同RN版本对应依赖版本可参考官方文档的版本对照表，避免跨版本兼容问题。

内容的提问来源于stack exchange，提问作者Yiğit Selçuk