iPhone端React Native应用出现No Bundle URL问题求助

解决iPhone真机运行React Native应用的「No Bundle URL」及调试版启动失败问题 #

1. 确认网络连通性 #

• 确保iPhone和开发电脑处于同一Wi-Fi网络，关闭电脑端防火墙或临时允许RN打包服务（默认端口8081）的网络请求。
• 在iPhone浏览器中访问 http://[你的电脑IP]:8081/index.bundle?platform=ios，能加载出bundle文件则网络正常；否则排查端口占用或网络设置。

2. 配置项目网络与打包地址 #

在Xcode中打开项目的Info.plist，添加/修改以下配置：

• 添加NSAppTransportSecurity字典，子键NSAllowsArbitraryLoads设为布尔值YES（仅调试环境使用，发布版本需删除该配置）。
• 添加RCTBundleURLProvider字典，子键localhost值设为你的电脑IP，确保应用能正确指向开发机的打包服务：

  <key>RCTBundleURLProvider</key>
  <dict>
    <key>localhost</key>
    <string>192.168.x.x</string> <!-- 替换为你的电脑实际IP -->
  </dict>
  

3. 彻底清理缓存并重建项目 #

执行以下命令清理所有缓存后重新构建：

# 重置React Native打包缓存
npx react-native start --reset-cache

# 清理iOS依赖与构建缓存
cd ios
pod deintegrate
pod install
cd ..

# 清理Xcode构建缓存
xcodebuild clean -workspace YourProject.xcworkspace -scheme YourProject -configuration Debug

完成后运行 npx react-native run-ios --device "你的iPhone名称"。

4. 排查项目自定义配置问题 #

• 检查AppDelegate.m/AppDelegate.swift中的bundle加载逻辑，避免硬编码仅适配模拟器的路径。
• 排查第三方依赖冲突：暂时移除近期新增的库，测试是否恢复正常，定位问题依赖后针对性处理。

5. 调试版启动失败的日志排查 #

• 打开Xcode的Window > Devices and Simulators，选中你的iPhone，查看Console面板的崩溃日志，根据具体报错定位问题。
• 确认iPhone已信任开发证书：进入设置 > 通用 > VPN与设备管理，找到你的开发证书并点击信任。

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