URLSession WebSocketTask进入后台后连接中断问题求助

问题背景 #

项目中使用URLSession.shared.webSocketTask(with: url)实现服务器实时更新监听，但应用进入后台再恢复前台时，连接会被中断，抛出Software caused connection abort错误（错误日志如下）：

2023-02-17 16:50:58.147335+0100 App[6057:327579] [connection] nw_read_request_report [C2] Receive failed with error "Software caused connection abort"
2023-02-17 16:50:58.147546+0100 App[6057:327579] [connection] nw_read_request_report [C1] Receive failed with error "Software caused connection abort"
2023-02-17 16:50:58.149527+0100 App[6057:327578] [websocket] Read completed with an error Software caused connection abort
2023-02-17 16:50:58.150047+0100 App[6057:327578] Task <5BFFE42D-3DC8-4B1F-BFB9-8E7985D588DF>.<1> finished with error [53] Error Domain=kNWErrorDomainPOSIX Code=53 "Software caused connection abort" UserInfo={NSDescription=Software caused connection abort, _NSURLErrorRelatedURLSessionTaskErrorKey=(
    "LocalWebSocketTask <5BFFE42D-3DC8-4B1F-BFB9-8E7985D588DF>.<1>"
), _NSURLErrorFailingURLSessionTaskErrorKey=LocalWebSocketTask <5BFFE42D-3DC8-4B1F-BFB9-8E7985D588DF>.<1>}
2023-02-17 16:50:58.152318+0100 App[6057:327579] [connection] nw_flow_add_write_request [C1 18.66.192.38:443 failed parent-flow (satisfied (Path is satisfied), interface: en0[802.11], ipv4, dns)] cannot accept write requests
2023-02-17 16:50:58.152392+0100 App[6057:327579] [connection] nw_write_request_report [C1] Send failed with error "Socket is not connected"
16:50:58 [LOG] error: Error Domain=kNWErrorDomainPOSIX Code=53 "Software caused connection abort" UserInfo={NSDescription=Software caused connection abort}

已尝试配置waitsForConnectivity=true、shouldUseExtendedBackgroundIdleMode=true，但问题依旧；使用后台URLSession时直接报错WebSocket tasks are not supported in background sessions。

可行优化方案 #

1. 调整URLSession配置参数 #

除了你已经设置的选项，补充以下配置来增强连接稳定性：

let config = URLSessionConfiguration.default
config.waitsForConnectivity = true
config.shouldUseExtendedBackgroundIdleMode = true
config.timeoutIntervalForRequest = 300 // 延长请求超时到5分钟
config.timeoutIntervalForResource = 3600 // 资源超时设为1小时
config.httpMaximumConnectionsPerHost = 1 // 限制单主机连接数，避免资源浪费
let session = URLSession(configuration: config, delegate: self, delegateQueue: OperationQueue())

注意：这些配置只能降低断开概率，无法彻底避免系统在后台掐断连接。

2. 监听应用生命周期+智能重连 #

iOS后台会严格限制网络活动，所以必须在生命周期切换时主动处理连接：

• 进入后台：发送心跳包（如果服务器支持），优雅取消当前任务避免触发错误；
• 回到前台：立即检查连接状态，断开则发起重连，同时用指数退避策略控制重连间隔（避免频繁请求服务器）。

代码示例：

// 注册生命周期通知
func setupLifecycleObservers() {
    NotificationCenter.default.addObserver(self, selector: #selector(onEnterBackground), name: UIApplication.didEnterBackgroundNotification, object: nil)
    NotificationCenter.default.addObserver(self, selector: #selector(onEnterForeground), name: UIApplication.willEnterForegroundNotification, object: nil)
}

@objc private func onEnterBackground() {
    // 发送心跳包维持连接（服务器需支持）
    webSocketTask.send(.string("ping")) { error in
        if let error = error {
            print("后台心跳发送失败: \(error.localizedDescription)")
        }
    }
    // 优雅取消任务，避免后台触发异常
    webSocketTask.cancel(policy: .graceful)
}

@objc private func onEnterForeground() {
    // 立即发起重连，初始延迟0秒
    reconnectWebSocket(delay: 0)
}

// 指数退避重连逻辑
private func reconnectWebSocket(delay: TimeInterval) {
    DispatchQueue.main.asyncAfter(deadline: .now() + delay) {
        // 重新创建WebSocket任务并启动监听
        self.webSocketTask = self.session.webSocketTask(with: self.webSocketURL)
        self.startWebSocketListening()
        self.webSocketTask.resume()
        
        // 下次重连延迟翻倍，最多30秒
        let nextDelay = min(delay * 2, 30)
        // 可以在这里添加失败重试逻辑，比如连续失败N次后停止
    }
}

// 启动WebSocket监听
private func startWebSocketListening() {
    webSocketTask.receive { result in
        switch result {
        case .success(let message):
            // 处理收到的消息
            self.startWebSocketListening() // 继续监听下一条消息
        case .failure(let error):
            print("WebSocket接收失败: \(error)")
            // 接收失败时触发重连，延迟1秒
            self.reconnectWebSocket(delay: 1)
        }
    }
}

3. 服务器端配合心跳机制 #

客户端和服务器定期发送心跳包（比如每30秒一次）：

• 客户端没收到服务器心跳超过阈值，触发重连；
• 服务器没收到客户端心跳，主动断开连接，避免无效连接占用资源。
  这是保持连接活性、快速检测断开的核心手段。

4. 接受重连的必要性 #

iOS系统后台的网络限制是硬性规则，没有办法让WebSocket连接在后台永久保持。因此可靠的重连机制是必须的，重连时可以恢复用户之前的状态（比如重新订阅频道、同步最新数据），让用户几乎感知不到断开。

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