React Native项目Android SDK版本不匹配问题的解决咨询

以下是针对你遇到的版本不匹配问题的具体解决方案：

1. 确认安装SDK Build Tools 33.0.0 #

你提到已安装android-33 SDK Platform，但React Native Doctor检测的是SDK Build Tools版本。打开Android Studio的SDK Manager：

• 切换到「SDK Tools」标签，勾选「Show Package Details」
• 展开「Android SDK Build Tools」，确认33.0.0版本已勾选并安装，若未安装则选中后点击「Apply」完成安装。

2. 验证环境变量的完整性 #

仅设置ANDROID_HOME还不够，需确保终端能正确调用SDK工具：

• 在终端执行以下命令验证路径：

  # Linux/macOS
  echo $ANDROID_HOME
  echo $PATH | grep -E "(tools|platform-tools)"
  # Windows（PowerShell）
  echo $env:ANDROID_HOME
  echo $env:PATH | Select-String -Pattern "tools|platform-tools"
  

• 执行sdkmanager --list，查看输出中是否包含build-tools;33.0.0和platforms;android-33，确认SDK确实被系统识别。

3. 强制Gradle使用指定SDK版本 #

确保项目的android/app/build.gradle中正确引用根配置的版本变量，避免版本不一致：

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
    buildToolsVersion rootProject.ext.buildToolsVersion

    defaultConfig {
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdkVersion rootProject.ext.targetSdkVersion
    }
}

随后清理缓存并重新同步：

# 清理Gradle缓存
cd android && ./gradlew clean && cd ..
# 清理React Native缓存
npx react-native clean

4. 统一Android Studio与环境变量的SDK路径 #

打开Android Studio，依次进入「File > Project Structure > SDK Location」，确认显示的SDK路径与ANDROID_HOME环境变量完全一致。若不一致，要么修改环境变量指向Studio的SDK路径，要么在Studio中更改SDK路径匹配环境变量。

5. 手动配置React Native Doctor的检查规则 #

如果上述步骤都无效，可通过配置文件强制Doctor使用指定版本：

• 在用户主目录下创建.react-native-doctor/config.json（Linux/macOS）或%USERPROFILE%/.react-native-doctor/config.json（Windows），内容如下：

  {
    "android": {
      "buildToolsVersion": "33.0.0",
      "compileSdkVersion": 33
    }
  }
  

• 重新运行npx react-native doctor，此时工具将按照指定版本进行检查。

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