升级Expo SDK后执行npx expo run:android遇react-native-screens配置错误

排查与修复步骤 #

1. 调整react-native-screens版本适配 #

Expo SDK 51（对应RN 0.74.5）官方兼容的react-native-screens版本虽包含3.31.1，但部分环境下存在适配细节问题。可尝试切换版本：

• 升级到兼容新版本：

  npm install react-native-screens@3.32.0
  

• 或降级到稳定兼容版：

  npm install react-native-screens@3.30.0
  

  执行后重新运行npx expo prebuild --clean和npx expo run:android。

2. 彻底清理缓存 #

新建项目也出现问题，大概率是全局或系统级缓存导致：

• 清除Expo缓存：

  npx expo start --clear
  

• 清理Android Gradle缓存：
  进入项目android目录，执行：

  ./gradlew cleanBuildCache
  

• 重置Node缓存：

  npm cache clean --force
  

3. 校验Android环境配置 #

Expo SDK 51对Android环境有明确要求：

• Android SDK Build Tools需≥34.0.0
• Gradle Wrapper版本需为8.7左右，Gradle插件版本≥8.2.0

检查android/build.gradle：

buildscript {
    dependencies {
        classpath("com.android.tools.build:gradle:8.2.0")
    }
}

检查android/gradle/wrapper/gradle-wrapper.properties：

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

不匹配则修改后重新构建。

4. 排查第三方依赖冲突 #

@react-native-google-signin/google-signin@12.2.1可能与当前环境存在冲突，临时移除测试：

npm uninstall @react-native-google-signin/google-signin

若构建成功，再重新引入该依赖并排查其兼容版本。

5. 确认Node.js版本 #

Expo SDK 51要求Node.js≥18.x，检查版本：

node --version

低于18则升级到LTS版本（18.x/20.x）后重装依赖。

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