React Native环境检测Android SDK异常，配置正常仍无法在手机运行

运行npx react-native doctor检测结果如下：
通用组件
✓ Node.js - 用于执行JavaScript代码
✓ npm - 用于安装NPM依赖

Android组件
✓ Adb - 用于验证Android设备是否正确连接
✓ JDK - 用于编译Java代码
✓ Android Studio - 用于在Android设备上构建和安装应用
✖ Android SDK - 用于在Android设备上构建和安装应用

• 检测到的版本：N/A
• 支持的版本：33.0.0
  ✓ ANDROID_HOME - 指向Android SDK安装路径的环境变量

错误数：1
警告数：0

已配置SDK环境变量及路径，但仍出现上述检测异常，需解决后在手机设备运行React Native应用。

具体修复步骤 #

1. 确认Android Studio中已安装指定版本SDK #

• 打开Android Studio，进入Settings（Windows/Linux：File > Settings；Mac：Android Studio > Settings）
• 导航到Appearance & Behavior > System Settings > Android SDK
• 在SDK Platforms标签下，勾选Android 13 (Tiramisu) SDK 33.0.0相关组件（至少包含SDK Platform）
• 切换到SDK Tools标签，勾选Android SDK Build-Tools 33.0.0（允许小版本差异，如33.0.2），点击Apply完成安装

2. 验证环境变量实际生效状态 #

打开终端执行以下命令，确认路径配置正确：

• Mac/Linux：

  echo $ANDROID_HOME
  echo $PATH | grep -E "(platform-tools|tools)"
  

• Windows（命令提示符）：

  echo %ANDROID_HOME%
  echo %PATH% | findstr /i "platform-tools tools"
  

如果输出未包含对应路径，需重启终端或电脑确保环境变量生效。

3. 在项目中手动指定SDK路径 #

在React Native项目根目录创建或编辑local.properties文件，添加SDK路径：

sdk.dir=/你的Android SDK绝对路径

示例路径：

• Mac：sdk.dir=/Users/xxx/Library/Android/sdk
• Windows：sdk.dir=C:\\Users\\xxx\\AppData\\Local\\Android\\Sdk

4. 清理缓存后重新检测 #

执行以下命令清空React Native缓存，再重新运行检测：

npx react-native start --reset-cache
npx react-native doctor

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