Expo React Native中图片无法加载问题求助
Expo React Native 图片加载失败排查方案
检查样式与布局问题
- 先移除
className="z-10",改用style={{ zIndex: 10 }}测试,确认是否是样式类未生效导致图片被其他元素遮挡 - 检查父容器的尺寸和
overflow属性,避免父容器尺寸为0或者overflow: hidden导致图片无法显示 - 尝试把固定宽高改成相对单位(比如
width: '100%', height: 140),适配不同设备的布局
- 先移除
排查网络请求配置
- 删掉
headers里的Accept: 'image/*',部分服务器对自定义请求头的处理存在兼容问题,默认请求头可能更稳定 - 用
Image.getSize单独验证图片URL的可用性:import { Image } from 'react-native'; Image.getSize('correct-url-of-my-image', (width, height) => console.log('图片尺寸:', width, height), (error) => console.log('获取尺寸失败:', error) ); - 若使用HTTP协议的图片URL,iOS设备需要在
Info.plist中配置NSAppTransportSecurity允许非HTTPS请求
- 删掉
本地资源加载额外检查
- 本地图片需确保路径正确(如
require('./assets/your-image.png')),且已在app.json的assets数组中注册对应目录 - 执行
expo r -c清理缓存后重启项目,避免缓存导致资源未更新
- 本地图片需确保路径正确(如
借助调试工具定位问题
- 打开Expo DevTools的Network面板,查看图片请求的状态码和响应内容,确认服务器返回的是有效图片资源
- 在
onError事件中打印完整错误详情:console.log('错误详情:', JSON.stringify(e.nativeEvent)),获取更具体的失败原因
内容的提问来源于stack exchange,提问作者Shubham Sharma
相关产品推荐
相关产品推荐

