使用nx运行React Native时react-native doctor提示Android SDK版本未找到

问题分析 #

你的环境里已安装的Android SDK Build Tools版本（30.0.3、31.0.0、34.0.0）和当前React Native项目要求的版本不匹配，导致React Native Doctor无法识别到符合要求的版本。

解决步骤 #

1. 确认项目的React Native版本 #

在项目根目录执行命令查看版本：

npm list react-native

或者直接查看package.json文件中react-native的版本号。

2. 安装对应版本的Android SDK Build Tools #

不同React Native版本对应推荐的Build Tools版本：

• React Native 0.68及以上：优先安装33.0.0或34.0.0
• React Native 0.64-0.67：推荐31.0.0
• React Native 0.60-0.63：推荐30.0.3

打开Android Studio的SDK Manager操作：

• 进入Appearance & Behavior > System Settings > Android SDK
• 切换到SDK Tools标签，勾选Show Package Details
• 展开Android SDK Build Tools，勾选对应版本后点击Apply完成安装

3. 验证环境变量配置 #

确保ANDROID_SDK_ROOT环境变量正确指向Android SDK安装路径：

• Windows：在系统环境变量中添加ANDROID_SDK_ROOT，值为你的SDK路径（例如C:\Users\你的用户名\AppData\Local\Android\Sdk）
• macOS/Linux：在~/.zshrc或~/.bashrc中添加：

  export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
  export PATH=$PATH:$ANDROID_SDK_ROOT/tools:$ANDROID_SDK_ROOT/platform-tools
  

  执行source ~/.zshrc（对应你的shell配置文件）使配置生效。

4. 重新检查 #

安装完成后，重新运行：

react-native doctor

确认问题是否解决。

5. NX项目额外检查 #

如果是NX管理的项目，检查project.json或workspace.json中Android配置的buildToolsVersion，确保和你安装的版本一致，不一致则修改为已安装的版本。

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