You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Expo搭建的React Native项目使用NativeBase UI后出现白屏问题求助

白屏问题排查解决方案
  • 第一步排查运行时报错:开启Expo开发调试模式,查看终端打包日志、设备端控制台的JS错误信息,90%以上的React Native白屏由JS代码执行抛出未捕获异常导致渲染终止,优先定位具体报错信息。
  • 第二步隔离问题组件:将代码中<Index />替换为NativeBase自带的基础组件验证,示例代码如下:
import { NativeBaseProvider, Box, Text } from "native-base";

export default function App() {
  return (
    <NativeBaseProvider>
      <Box flex={1} bg="white" alignItems="center" justifyContent="center">
        <Text>测试渲染</Text>
      </Box>
    </NativeBaseProvider>
  );
}

如果替换后页面正常显示,说明故障出在./src/Home目录下的Index组件内部,可进一步排查该组件的代码逻辑、属性调用、状态初始化是否存在错误。

  • 第三步校验依赖兼容性:检查NativeBase和当前Expo版本的匹配性,NativeBase运行所需的react-native-svg、react-native-safe-area-context等依赖必须通过expo install命令安装,避免版本不兼容问题,安装完成后重启项目验证。
  • 第四步清理缓存重试:执行expo start -c命令清空Expo本地缓存后重启项目,若仍有问题可删除node_modules、package-lock.json(或yarn.lock)文件后重新执行依赖安装再启动。
  • 第五步排查主题配置错误:如果项目自定义了NativeBase的全局主题,检查主题配置代码是否存在语法错误、属性值不合法的问题,错误的主题配置会导致NativeBaseProvider初始化失败触发白屏。

内容的提问来源于stack exchange,提问作者Osamah Amer

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.06 01:45:01