M1 Mac下React Native iOS真机终端按R触发reload失败问题咨询

报错内容 #

warn No apps connected. Sending "reload" to all React Native apps failed. Make sure your app is running in the simulator or on a phone connected via USB.
info Reloading app...

产生原因 #

• M1芯片Mac的底层网络栈和Intel架构存在差异，默认情况下Metro服务未正确绑定USB连接的iOS设备对应的端口映射，无法识别到真机的调试会话。
• iOS14及以上系统新增了本地网络权限限制，若RN应用未被授予该权限，只能主动向Metro服务发起请求（比如调试菜单的重载指令），无法接收Metro从终端发起的反向指令。
• Xcode未开启设备的网络调试配置，USB连接的端口转发规则未生效，导致Metro扫描不到已连接的真机。
• 0.64~0.68区间的React Native版本存在兼容性bug，对M1芯片+iOS14真机的调试连接识别逻辑有缺陷，无法触发终端R键对应的重载指令。

可行解决方案 #

• 开启应用本地网络权限：打开iPhone系统设置，找到对应的RN应用，开启本地网络权限，重启应用后重新连接Metro即可。
• 配置Xcode设备调试选项：打开Xcode顶部菜单栏的Window->Devices and Simulators，找到已连接的iPhone X，勾选Connect via network选项，重新插拔USB后再运行RN应用。
• 手动配置端口转发：终端执行brew install usbmuxd安装端口转发工具，之后执行iproxy 8081 8081保持该终端运行，再新开一个终端启动Metro服务即可正常识别真机。
• 调整Metro启动参数：启动Metro时指定监听所有网络接口，执行npx react-native start --host 0.0.0.0，也可以加上重置缓存参数--reset-cache清除旧的错误配置。
• 调整React Native版本：如果当前使用的是0.64~0.68版本的RN，可升级到0.69+正式版，或者降级到0.63.4稳定版，规避版本兼容性问题。

内容的提问来源于stack exchange，提问作者Pirta Matharu