实体iOS设备无法连接Metro的技术问题求助

问题场景 #

• 模拟器运行正常，iOS真机（iOS 17.7.1）运行失败，偶尔弹出No bundle URL present错误
• 已确认设备与电脑同网络，通过摇一摇添加bundle URL无效
• Safari无法访问电脑8081端口的bundle地址
• 已执行yarn cache clean、重新pod install，且应用已获取本地网络权限，均未解决
• 环境：Xcode 14.3.1，iOS 17.7.1

排查&解决步骤 #

1. 修改Metro启动绑定地址
   启动Metro时绑定0.0.0.0，确保真机能访问本地服务：

   npx react-native start --host 0.0.0.0
   

   也可以直接修改package.json的启动脚本，避免每次手动加参数：

   "scripts": {
     "start": "react-native start --host 0.0.0.0"
   }
   

2. 检查电脑防火墙拦截
   临时关闭电脑防火墙测试，或手动允许node进程（Metro依赖）通过防火墙访问网络，防止8081端口被拦截。

3. 验证网络连通性
   在真机Safari中访问电脑局域网IP+8081（比如http://192.168.x.x:8081）：

   • 若无法访问，先通过ifconfig（Mac）或ipconfig（Windows）确认电脑局域网IP是否正确
   • 检查路由器是否开启AP隔离模式，开启的话需关闭

4. 调整Xcode项目配置

   • 打开Xcode项目，进入Build Settings，搜索Allow Arbitrary Loads并设置为YES，确保能加载非HTTPS的本地bundle
   • 确认Info.plist中NSLocalNetworkUsageDescription配置正确（已获取权限可跳过）

5. 完整清理项目缓存与构建产物
   执行以下命令彻底清理后重新构建：

   # 重置Metro缓存
   npx react-native start --reset-cache
   # 清理iOS端产物并重新安装依赖
   cd ios && rm -rf Pods Podfile.lock build && pod install --repo-update && cd ..
   # 清理yarn缓存
   yarn cache clean
   

6. 确认bundle URL正确性
   摇一摇打开开发者菜单后，输入的bundle URL必须是电脑局域网IP+完整路径，比如：

   http://192.168.1.100:8081/index.bundle?platform=ios&dev=true&minify=false
   

   禁止使用localhost或127.0.0.1，真机无法解析这类本地回环地址。

7. 适配Xcode与iOS版本兼容性
   Xcode 14.3.1对iOS 17的支持存在兼容性问题，可尝试：

   • 更新Xcode到最新稳定版（如15.x），或降级iOS设备系统到Xcode 14.3.1支持的最高版本（iOS 16.x）
   • 若无法更新Xcode，在Podfile中添加适配配置后重新执行pod install：

     post_install do |installer|
       installer.pods_project.targets.each do |target|
         target.build_configurations.each do |config|
           config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.0'
           config.build_settings['ENABLE_BITCODE'] = 'NO'
         end
       end
     end
     

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