物理iPhone上NWConnection连接始终失败，模拟器正常求助

问题场景 #

• 物理iPhone（iOS 18.1）使用NWConnection建立本地TCP连接时，反复报错waiting(POSIXErrorCode(rawValue: 50): Network is down)，无网络流量产生
• iOS模拟器运行相同代码可正常建立连接
• 首次授予本地网络权限后问题持续，仅在修改代码（无功能变更）重新构建后恢复正常，后续连接稳定

排查与解决方向 #

1. 处理iOS 18本地网络权限延迟生效问题 #

iOS 18可能存在首次授予本地网络权限后，系统未立即同步权限状态的bug，导致NWConnection无法发起连接。修改代码重新构建会触发应用重新签名，强制系统加载最新的权限配置。

• 临时解决：首次允许权限后，彻底重启应用（而非后台划掉），再尝试发起连接
• 代码优化：添加网络路径监控，确认本地网络权限生效后再启动连接：

  let pathMonitor = NWPathMonitor()
  pathMonitor.pathUpdateHandler = { path in
      if path.status == .satisfied && path.usesInterfaceType(.wifi) {
          // 确认网络可用且在WiFi环境（本地网络场景），启动连接
          let connection = self.startConnection()
      }
  }
  pathMonitor.start(queue: DispatchQueue(label: "com.yourapp.pathmonitor"))
  

2. 完善Info.plist网络权限配置 #

除了NSLocalNetworkUsageDescription，可额外添加NSBonjourServices键（即使不使用Bonjour服务），帮助系统明确应用的本地网络需求：

<key>NSBonjourServices</key>
<array>
    <string>_tcp._local.</string>
</array>

3. 使用专用队列处理NWConnection操作 #

避免在主线程启动NWConnection，改用后台专用队列，减少主线程阻塞对网络状态更新的影响：

func start() -> NWConnection {
    let myHost: NWEndpoint.Host = "192.168.1.154"
    let myPort: NWEndpoint.Port = 1234
    let connection = NWConnection(to: .hostPort(host: myHost, port: myPort), using: .tcp)
    connection.stateUpdateHandler = { newState in
        switch newState {
        case .waiting(let error):
            print("Connection waiting: \(error)")
        case .failed(let error):
            print("Connection failed: \(error)")
        case .ready:
            print("Connection ready")
        default:
            print("Connection state: \(newState)")
        }
    }
    // 使用后台队列
    let networkQueue = DispatchQueue(label: "com.yourapp.network", qos: .background)
    connection.start(queue: networkQueue)
    return connection
}

4. 升级系统版本排查兼容性问题 #

iOS 18.1属于较新的系统版本，可能存在Network Framework的已知bug。尝试升级到最新的iOS 18正式版或开发者预览版，查看问题是否消失。

内容的提问来源于stack exchange，提问作者Eric L.