React Native iOS模拟器白屏：Expo启动后仅Web端正常
2026-8-21
Expo项目Web端正常，Xcode模拟器启动后持续白屏
我的Expo项目在Web端运行完全正常，但执行expo start命令后，在Xcode模拟器中打开应用一直卡在白屏状态。已经尝试过以下操作，问题仍未解决：
- 删除
node_modules、package-lock.json文件后重新执行npm install - 多次重载模拟器内的应用
- 重启Expo开发服务器
附相关截图：
排查与解决建议
- 查看Expo终端日志：启动
expo start后，留意终端输出的报错信息，比如依赖缺失、权限配置问题、Metro服务器异常等，这是定位白屏原因的关键。 - 清除Expo缓存：执行
expo start -c清除缓存后重新启动，缓存冲突是常见的原生端加载异常诱因。 - 匹配Xcode与模拟器版本：确保Xcode为最新稳定版，模拟器的iOS版本和项目
app.json/app.config.js中配置的ios.deploymentTarget一致。 - 检查入口文件语法：确认项目入口文件（如
App.js）无语法错误，Web端兼容的部分语法可能在原生端不支持，需确保代码被正确转译。 - 排查依赖兼容性：部分npm包仅支持Web环境，在原生端会导致加载失败。可以临时移除近期新增的依赖，逐个测试定位问题包。
- 重置模拟器状态：在Xcode模拟器中选择
Device > Erase All Content and Settings，清除模拟器本地缓存后重新加载应用。
内容的提问来源于stack exchange，提问作者RandomDeveloper
相关产品推荐
相关产品推荐
