无法启动已有React Native项目：Gradle及iOS构建异常

Android 端初始报错 #

运行npm start后 Android 构建失败，报错信息如下：

info 正在 Android 上打开应用...
info JS 服务器已在运行。
info 正在安装应用...

FAILURE: 构建因异常失败。

* 出错原因:
配置项目 ':react-native-gradle-plugin' 时出现问题。
> 无法使用 ExecutionGradleServices.createOutputFilesRepository() 创建 OutputFilesRepository 类型的服务。
   > 创建目录 '/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/react-native-gradle-plugin/.gradle/buildOutputCleanup' 时，无法创建父目录 '/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/react-native-gradle-plugin/.gradle'

* 尝试方案:
> 使用 --stacktrace 选项获取堆栈跟踪。
> 使用 --info 或 --debug 选项获取更多日志输出。
> 使用 --scan 选项获取完整分析信息。

* 更多帮助请访问 https://help.gradle.org

BUILD FAILED in 6s

Error: 命令执行失败: ./gradlew app:installDebug -PreactNativeDevServerPort=8081

FAILURE: 构建因异常失败。

* 出错原因:
配置项目 ':react-native-gradle-plugin' 时出现问题。
> 无法使用 ExecutionGradleServices.createOutputFilesRepository() 创建 OutputFilesRepository 类型的服务。
   > 创建目录 '/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/react-native-gradle-plugin/.gradle/buildOutputCleanup' 时，无法创建父目录 '/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/react-native-gradle-plugin/.gradle'

* 尝试方案:
> 使用 --stacktrace 选项获取堆栈跟踪。
> 使用 --info 或 --debug 选项获取更多日志输出。
> 使用 --scan 选项获取完整分析信息。

* 更多帮助请访问 https://help.gradle.org

BUILD FAILED in 6s

    at makeError (/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:174:9)
    at /Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:278:16
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async runOnAllDevices (/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/@react-native-community/cli-platform-android/build/commands/runAndroid/runOnAllDevices.js:82:7)
    at async Command.handleAction (/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/@react-native-community/cli/build/index.js:108:9)
info 使用 --verbose 标志运行 CLI 以获取更多详细信息。

解决思路 #

• 修复目录权限：给目标目录添加读写权限

  chmod -R 755 "/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/react-native-gradle-plugin"
  

• 手动创建缺失目录：直接生成报错中提到的目录结构

  mkdir -p "/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/node_modules/react-native-gradle-plugin/.gradle/buildOutputCleanup"
  

• 清理 Gradle 全局缓存：删除缓存后重新构建

  rm -rf ~/.gradle/caches
  

iOS 端报错 #

运行npm start启动 iOS 应用时出现异常：

名为"ealpha"的工作区不包含名为"ealpha"的 scheme。可使用"-list"选项查看工作区中的所有 scheme 名称。

解决思路 #

• 检查并配置 Xcode Scheme：
  1. 打开 iOS 项目的.xcworkspace文件
  2. 点击顶部菜单栏Product -> Scheme -> Manage Schemes
  3. 确认是否存在ealpha scheme，不存在则创建，同时勾选Shared选项
• 重新执行 CocoaPods 安装：

  cd ios && pod install && cd ..
  

更新后 Android 新报错 #

后续运行出现新的构建错误：

* 出错原因:
无法打开设置文件 '/Users/ealpha4tech/Downloads/ealpha4-mobile-main 2/android/settings.gradle' 的通用类缓存 (/Users/ealpha4tech/.gradle/caches/7.5.1/scripts/bx94o9il2py3wpbok5l2mnec2)。
> BUG! 源单元 '_BuildScript_' 的 '语义分析' 阶段出现异常 不支持的类文件主版本 65

解决思路 #

• 降级 Java 版本：类文件主版本65对应Java21，Gradle7.5.1不支持，需降级到Java17及以下
  1. 检查当前Java版本：java -version
  2. 安装Java17：brew install openjdk@17
  3. 配置环境变量：

     echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
     source ~/.zshrc
     

• 升级 Gradle 版本：将Gradle升级到支持Java21的版本（如8.0+），修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

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