如何处理NWConnection连接超时问题？

核心问题原因 #

NWConnection 默认不会将连接超时作为明确的状态变更触发stateUpdateHandler，底层socket的超时错误仅会在系统日志中打印，不会主动同步到上层的状态回调逻辑里。

解决方案：手动添加超时控制逻辑 #

最可靠的处理方式是在启动连接后，手动设置一个超时定时器，当超过指定时间仍未进入预期状态（如.ready）时，主动终止连接并处理超时事件。

代码示例

let connection = NWConnection(to: endpoint, using: .tcp)
var timeoutTimer: Timer?

connection.stateUpdateHandler = { [weak self] newState in
    guard let self = self else { return }
    print("newState: \(newState)")
    
    // 连接进入稳定状态（就绪/失败/已取消）时，销毁定时器
    switch newState {
    case .ready, .failed, .cancelled:
        self.timeoutTimer?.invalidate()
        self.timeoutTimer = nil
    default:
        break
    }
}

// 启动连接
connection.start(queue: .main)

// 设置超时时间（示例为10秒），超时后主动断开连接并处理事件
self.timeoutTimer = Timer.scheduledTimer(withTimeInterval: 10, repeats: false) { [weak self] _ in
    guard let self = self else { return }
    print("连接超时，主动终止")
    self.connection.cancel()
    // 这里可根据业务需求，通知上层模块处理超时逻辑
}

额外注意事项 #

• 使用weak self避免循环引用，防止内存泄漏。
• 超时时间可根据业务场景调整（内网服务可设较短，公网服务适当延长）。
• 若需要更精细的网络状态监听，可结合connection.pathUpdateHandler跟踪网络路径变化，提前预判连接风险。

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