React Native安卓设备运行报错:包服务器未运行、USB调试未启用及热加载连接失败
解决React Native安卓应用启动报错的常见问题
Hey,这些都是React Native开发初期很常见的坑,我帮你拆解一下每个问题的解决办法:
1. 解决"Hot loading isn't working because it cannot connect to the development server"报错
虽然你已经关闭了热加载,但应用可能还在默认尝试连接开发服务器,试试这两个方案:
- 指定开发服务器地址(适合调试阶段):
- 摇晃设备调出开发者菜单(或者在终端运行
adb shell input keyevent 82) - 进入「Dev Settings」→「Debug server host & port for device」
- 输入你的电脑局域网IP + 8081端口(比如
192.168.3.10:8081,确保电脑和设备连同一个WiFi) - 返回开发者菜单选择「Reload」重新加载应用
- 摇晃设备调出开发者菜单(或者在终端运行
- 打包离线正式包(适合不需要调试的场景):
在项目根目录终端运行:
这个命令会生成不依赖开发服务器的正式包,直接点击图标就能启动。react-native run-android --variant=release
2. 解决包服务器未运行的问题
每次启动应用前,一定要确保Metro包服务器处于运行状态:
- 打开终端进入项目根目录,运行:
等看到「Metro is ready」的提示后,再重启设备上的应用;npx react-native start - 如果服务器运行但还是连不上,试试清除Metro缓存:
npx react-native start --reset-cache
3. 解决USB调试未启用导致的运行报错
先仔细检查USB调试的配置:
- 确保设备的「开发者选项」已开启(没显示的话,去「关于手机」连续点7次版本号);
- 开启「USB调试」和「USB安装」两个选项;
- 连接电脑时,设备弹出的「允许USB调试」对话框一定要选「允许」,并勾选「始终允许此计算机」;
- 如果adb识别不到设备,重启adb服务试试:
另外,换一根能传数据的USB线(很多廉价线只能充电)。adb kill-server adb start-server
内容的提问来源于stack exchange,提问作者pixel




