编译React Native项目报Expo native runtime不可用错误,应用白屏如何解决
问题修复方案
1 修复App.js基础语法错误
你当前代码中使用了React Native内置的<Text>组件但未提前导入,这是导致页面白屏的核心原因之一,修改后的代码如下:
import 'react-native-gesture-handler'; import React from 'react'; // 新增Text组件导入 import { Text } from 'react-native'; export default function App() { return (<Text>Hello, I am your cat!</Text>); };
2 解决Expo native runtime报错问题
你项目的package.json同时包含Expo相关依赖和原生React Native的运行脚本,属于Expo裸工作流项目,出现运行时缺失可按以下步骤排查:
- 确认启动流程匹配你的项目类型:
- 如果你尚未执行eject操作,属于Expo托管项目,不要使用
react-native run-android/ios命令启动,直接执行npx expo start,在弹出的面板中选择对应运行端即可 - 如果你已经执行eject转为原生开发模式,运行前必须先开一个终端执行
npm start启动Metro打包服务,再开第二个终端执行对应端的运行命令,不可跳过Metro启动步骤
- 如果你尚未执行eject操作,属于Expo托管项目,不要使用
- 检查原生端配置:已经eject的项目需要确认原生工程中已经完成react-native-unimodules的集成配置,安卓端检查MainApplication.java的包注册逻辑,iOS端检查Podfile配置和AppDelegate的注册代码,缺失unimodules原生注册会直接触发Expo运行时报错
- 清理缓存重试:如果是依赖或缓存异常导致的问题,执行以下命令重置环境后重新运行:
# 重装依赖 rm -rf node_modules package-lock.json npm install # 重置Metro缓存 npx react-native start --reset-cache # 安卓端额外清理构建缓存 cd android && ./gradlew clean && cd ..
3 白屏辅助排查
修改完成后如果仍显示白屏,可在运行的模拟器/真机上按两次R键手动重载JS bundle,或摇一摇设备打开开发者调试菜单,查看具体报错信息定位问题。
内容的提问来源于stack exchange,提问作者Faisal Mushtaq
相关产品推荐
相关产品推荐

