You need to enable JavaScript to run this app. 编译React Native项目报Expo native runtime不可用错误,应用白屏如何解决
优惠活动
大模型
产品
解决方案
定价
更多

编译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的项目需要确认原生工程中已经完成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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 23:36:08