React Native安卓模拟器中URL图片无法显示问题求助

API 探路者

2026-8-11

解决React Native安卓模拟器无法加载URL图片的问题

检查安卓模拟器网络连接
打开模拟器自带浏览器，输入图片URL，确认能否正常打开。如果打不开，说明模拟器网络存在问题：可以尝试重启模拟器，或者检查电脑的代理设置（关闭不必要的代理，或是给模拟器配置对应代理）。部分模拟器比如Genymotion，需要手动确认虚拟设备的网络连接处于启用状态。
确认AndroidManifest.xml的权限配置
首先确保已添加网络权限：
```
<uses-permission android:name="android.permission.INTERNET" />
```
虽然你已经添加了android:usesCleartextTraffic="true"，但Android 9及以上系统如果有自定义的network_security_config.xml，要检查是否允许访问目标HTTPS域名。如果没有这个文件，直接新建res/xml/network_security_config.xml，内容如下：
```
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>
```
然后在AndroidManifest.xml的application标签里添加引用：
```
android:networkSecurityConfig="@xml/network_security_config"
```
验证图片URL的可用性
有些图片网站存在防盗链或地域限制，换一个公开测试图试试，比如：
```
<Image resizeMode="cover" 
       source={{ uri: 'https://picsum.photos/200' }} 
       style={{ width: 140, height: 140}} />
```
如果测试图能正常显示，说明原URL的网站有访问限制，更换其他图片源即可。
清理缓存重新构建
在项目根目录执行命令清理安卓缓存：
```
./gradlew clean
```
重启模拟器后，重新运行项目：
```
npx react-native run-android
```
更换模拟器系统版本
旧版安卓模拟器对HTTPS请求的兼容性可能不佳，尝试换成Android 10及以上版本的模拟器镜像。