React Native EAS构建后启动页出现空白屏，如何调试？

以下是针对该问题的具体排查和解决步骤：

• 检查React Navigation兼容性
  你当前使用的react-navigation是4.x版本，而Expo 47对应的React Native版本为0.70.5，两者存在兼容风险。建议升级到react-navigation 6.x版本，该版本对RN 0.70+有官方适配；若暂时无法升级，可查看社区是否有针对4.x版本的适配补丁。

• 排查Expo Updates配置
  EAS构建默认启用expo-updates，可能因更新逻辑导致启动异常：

  • 临时禁用更新测试：在app.json中添加或修改配置：

    "updates": {
      "enabled": false
    }
    

  • 清除构建缓存后重新构建：执行命令 eas build --platform android --clear-cache

• 验证Native Base兼容性
  确认native-base 3.4.25是否适配Expo 47（RN 0.70.5），建议查看Native Base官方文档，或升级到最新兼容版本。

• 检查字体加载逻辑
  expo-app-loading加载字体时，生产构建可能存在资源打包问题：

  • 确保字体加载完成后再渲染主应用，示例逻辑：

    import AppLoading from 'expo-app-loading';
    import { useFonts } from 'expo-font';
    
    export default function App() {
      const [fontsLoaded] = useFonts({
        // 替换为你的字体配置，比如：
        // 'Roboto': require('./assets/fonts/Roboto-Regular.ttf'),
      });
    
      if (!fontsLoaded) {
        return <AppLoading />;
      }
    
      return <YourMainAppComponent />;
    }
    

  • 确认字体文件路径正确，且EAS构建时已将资源正确打包。

• 调试生产构建错误

  • 通过adb logcat *:E查看Android设备的错误日志，定位启动阶段的异常信息
  • 在eas.json的构建配置中添加developmentClient: true，构建后用Expo Dev Client打开APK，查看调试控制台的错误输出

• 运行依赖检查
  执行npx expo doctor扫描项目依赖，根据提示修复冲突或不兼容的依赖项。

• 验证第三方依赖适配性
  检查react-native-view-pdf、react-native-permissions等第三方库是否支持RN 0.70.5版本，若存在版本不兼容，升级到对应适配版本。

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