React Native APK安装运行时触发Metro错误,已配置cleartextTraffic仍未解决
解决React Native Debug APK安装后报错问题
生成包含离线Bundle的Debug APK
直接通过react-native run-android运行时,应用依赖本地Metro服务器实时加载代码,但GitHub上的Debug APK默认可能没打包离线Bundle,导致安装后无法加载资源。执行以下步骤生成带Bundle的APK:- 生成离线Bundle文件:
react-native bundle --platform android --dev true --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/ - 重新编译Debug APK:
cd android && ./gradlew assembleDebug
用这个新生成的APK安装测试。
- 生成离线Bundle文件:
配置Debug服务器地址(或启用离线模式)
如果需要连接本地Metro调试,确保手机和电脑在同一WiFi网络:- 打开应用后摇一摇唤出开发者菜单,选择「Dev Settings」
- 进入「Debug server host & port for device」,输入你的电脑IP地址+Metro端口(比如
192.168.1.100:8081) - 或者直接勾选「Enable Offline Bundle」,让应用使用本地打包的资源,无需连接Metro
检查基础权限配置
确认AndroidManifest.xml里是否添加了网络权限:<uses-permission android:name="android.permission.INTERNET" />虽然Debug模式默认会添加,但如果被误移除也会导致网络连接相关错误。
重置Metro缓存
缓存异常可能导致Bundle生成不完整,执行以下命令清空缓存后重新打包:react-native start --reset-cache
内容的提问来源于stack exchange,提问作者eitan
相关产品推荐
相关产品推荐

