Expo React Native应用仅显示启动页无法跳转问题求助

可能的常见原因 #

• 缓存残留：重启电脑后Metro缓存或原生项目缓存未清理，导致启动逻辑阻塞
• 依赖异常：关机重启后部分依赖包丢失或损坏，比如node_modules、iOS的Pods或Android的gradle缓存
• 启动逻辑阻塞：入口文件（如App.js）中存在未正确处理的异步操作（比如未完成的API请求、Promise未resolve），导致页面无法渲染
• 原生配置错误：此前修改的原生配置（AndroidManifest.xml、Info.plist等）未生效或存在问题

日志查看方式 #

1. Metro终端日志 #

运行npx react-native start的终端窗口会输出RN层面的错误或警告，即使无红色报错，也可能有黄色提示（如异步超时、模块加载失败），重点关注启动阶段的输出。

2. Android日志 #

• 打开Android Studio的Logcat，选择对应设备和应用进程，过滤ReactNative或Error关键词，查看原生层面报错（如权限问题、原生模块初始化失败）
• 终端运行命令：adb logcat *:E ReactNative:V ReactNativeJS:V，直接输出RN相关的错误与日志

3. iOS日志 #

• 打开Xcode，选择目标模拟器/真机，打开Console面板，过滤应用名称，查看启动过程中的报错信息
• 终端运行命令：xcrun simctl spawn <设备UDID> log stream --level debug --predicate 'process == "你的应用名称"'，获取iOS设备实时日志

快速排查步骤 #

1. 清理各类缓存

   • Metro缓存：运行npx react-native start --reset-cache
   • iOS：进入ios目录，删除Pods文件夹和Podfile.lock，重新执行pod install；Xcode中按Command+Shift+K清理项目缓存
   • Android：进入android目录，运行./gradlew clean清理gradle缓存

2. 检查入口文件逻辑

   • 打开App.js或index.js，排查组件挂载时的异步操作（如useEffect中的API请求），是否存在未处理的Promise拒绝、无限循环等情况
   • 临时注释非必要异步代码，测试能否正常跳转，逐步定位问题代码

3. 校验原生配置

   • Android：确认AndroidManifest.xml中主Activity的intent-filter、权限配置正确
   • iOS：确认Info.plist中启动页资源配置正常，主ViewController设置无误

4. 重新安装依赖

   • 删除node_modules文件夹和package-lock.json/yarn.lock，重新执行npm install或yarn install

内容的提问来源于stack exchange，提问作者alperen gökçek