执行Gradle同步时出现找不到'react-native/cli'模块的错误求助

Hey，我之前也遇到过一模一样的问题！这个错误本质是Gradle在执行React Native相关构建脚本时，找不到react-native/cli模块导致的，通常是本地依赖没装全、全局和本地CLI版本冲突，或者Node的模块查找路径出了问题。给你几个亲测有效的解决步骤：

方案1：彻底重装项目本地依赖 #

这是最常见的修复方式，很多时候都是node_modules损坏或者依赖没安装完全导致的：

• 先打开终端，进入你的项目根目录：C:\Users\James\AndroidStudioProjects\Test-app\
• 执行命令清理现有依赖（Windows用PowerShell的话，把rm换成Remove-Item）：

  # Windows PowerShell 命令
  Remove-Item -Recurse -Force node_modules
  Remove-Item package-lock.json
  npm cache clean --force
  

  # 如果是Git Bash/其他类Unix终端
  rm -rf node_modules
  rm package-lock.json
  npm cache clean --force
  

• 然后重新安装所有依赖：

  npm install
  

• 安装完成后回到Android Studio，重新执行「Sync Project with Gradle Files」。

方案2：手动指定Gradle使用本地CLI路径 #

你的项目用的是@react-native-community/cli社区版，但Gradle可能默认去全局找旧版的react-native-cli，可以手动在Gradle配置里指定本地CLI路径：

• 打开项目里的android/settings.gradle文件（路径：C:\Users\James\AndroidStudioProjects\Test-app\android\settings.gradle）
• 在文件开头添加以下配置，指定本地CLI的位置：

  rootProject.name = 'Test-app'
  include ':app'
  
  // 新增：指定本地@react-native-community/cli路径
  def reactNativeProjectDir = new File(rootProject.projectDir, "../")
  def cliPlatformAndroidPath = new File(reactNativeProjectDir, "node_modules/@react-native-community/cli-platform-android")
  includeBuild(cliPlatformAndroidPath)
  

• 保存文件后，重新Sync Gradle。

方案3：清理全局CLI依赖，避免版本冲突 #

你全局npm里也安装了@react-native-community/cli相关模块，这很可能和项目本地的版本产生冲突：

• 先卸载全局的React Native CLI相关包：

  npm uninstall -g react-native-cli
  npm uninstall -g @react-native-community/cli
  

• 然后打开项目根目录的package.json，确认devDependencies里的CLI版本和你本地node_modules里的一致（比如你用的3.1.4）：

  "devDependencies": {
    "@react-native-community/cli-platform-android": "^3.1.4",
    "@react-native-community/cli-tools": "^3.1.4",
    // 其他依赖...
  }
  

• 再次执行npm install，确保依赖版本统一。

方案4：检查Node模块的查找路径 #

有时候Node会因为环境变量问题，找不到项目本地的node_modules，可以验证一下：

• 在项目根目录执行命令，查看Node的模块查找路径：

  node -e "console.log(module.paths)"
  

• 检查输出里是否包含你的项目node_modules路径：C:\Users\James\AndroidStudioProjects\Test-app\node_modules
• 如果没有，临时设置NODE_PATH环境变量（仅当前终端有效）：

  set NODE_PATH=C:\Users\James\AndroidStudioProjects\Test-app\node_modules
  

• 然后关闭并重新打开Android Studio，再尝试Sync。

优先试试方案1，大部分情况都能解决；如果不行再依次试后面的方案，应该能搞定！

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