iOS 16.6下自签名SSL WebSocket连接超时及同步问题排查

1. 30秒超时（Error -1001）原因排查 #

• 心跳机制缺失：iOS的URLSessionWebSocketTask不会主动维持连接，若服务端设置了30秒无数据自动断开规则，就会触发超时。先确认服务端是否配置了心跳发送，或客户端有没有主动发送ping帧的逻辑。
• SSL握手不完整：虽然已在iPhone上信任自签名证书，但WSL服务端的证书可能存在链不完整问题。在WSL终端执行openssl s_client -connect 你的服务器地址:端口，查看SSL握手状态，确保无verify return:1以外的警告，握手全程无报错。
• 网络与防火墙限制：检查Windows防火墙是否允许WSL的WebSocket端口（如443或自定义端口）的入站/出站流量；确认iPhone和PC在同一局域网，部分家用路由器会对无数据连接设置30秒超时，需在路由器后台调整TCP超时时间。
• URLSession配置问题：检查URLSessionConfiguration中的timeoutIntervalForRequest和timeoutIntervalForResource是否被误设为30秒；确保开启waitsForConnectivity，避免网络波动直接导致连接失败。

2. 持久连接维持方案 #

• 主动心跳交互：客户端实现定时ping机制，每隔25秒（小于服务端超时时间）发送ping帧，示例代码：

  private var pingTimer: Timer?
  
  func startHeartbeat() {
      pingTimer = Timer.scheduledTimer(withTimeInterval: 25, repeats: true) { [weak self] _ in
          guard let task = self?.webSocketTask else { return }
          task.sendPing { error in
              if let error = error {
                  print("Ping发送失败: \(error.localizedDescription)")
              }
          }
      }
  }
  

  同时确保服务端收到ping后回复pong，形成完整心跳闭环。
• 断开自动重连：在URLSessionWebSocketDelegate的webSocketTask(_:didCloseWith:reason:)回调里触发重连逻辑，加入指数退避策略避免频繁重试：

  private var reconnectDelay: TimeInterval = 1
  
  func webSocketTask(_ webSocketTask: URLSessionWebSocketTask, didCloseWith closeCode: URLSessionWebSocketTask.CloseCode, reason: Data?) {
      reconnectDelay = min(reconnectDelay * 2, 60)
      reconnect(withDelay: reconnectDelay)
  }
  
  private func reconnect(withDelay delay: TimeInterval) {
      DispatchQueue.global().asyncAfter(deadline: .now() + delay) { [weak self] in
          self?.setupWebSocketConnection()
      }
  }
  

• 后台连接配置：若需App在后台保持连接，在Info.plist中添加UIBackgroundModes并勾选fetch或remote-notification；使用后台URLSession配置：

  let config = URLSessionConfiguration.background(withIdentifier: "com.yourapp.websocket")
  let session = URLSession(configuration: config, delegate: self, delegateQueue: nil)
  

3. 地图更新同步失败排查 #

• 服务端推送逻辑验证：确认服务端生成地图更新消息时，是否将iOS客户端的连接纳入推送列表。Python客户端能接收，说明服务端可能对客户端类型做了过滤，或iOS端连接ID未正确注册到推送池，可在服务端打印所有在线连接信息排查。
• 客户端接收解析检查：在iOS端的webSocketTask(_:didReceive:)回调里打印原始接收数据，确认是否收到地图更新消息。若未收到则排查服务端发送逻辑；若收到但解析失败，检查数据格式是否与Python端一致（如JSON字段名、数据类型），捕获解析错误：

  func webSocketTask(_ webSocketTask: URLSessionWebSocketTask, didReceive message: URLSessionWebSocketTask.Message) {
      switch message {
      case .string(let text):
          print("收到消息: \(text)")
          do {
              let mapData = try JSONDecoder().decode(MapUpdate.self, from: text.data(using: .utf8)!)
              DispatchQueue.main.async {
                  // 更新地图UI
              }
          } catch {
              print("解析失败: \(error)")
          }
      case .data(let data):
          print("收到二进制数据: \(data.count) bytes")
      @unknown default:
          break
      }
  }
  

• 传输阻塞排查：若心跳正常但消息丢失，可能是服务端发送缓冲区已满，或iOS端接收队列被阻塞。在服务端检查消息发送返回状态，确保消息成功发出；客户端处理消息时用异步队列，避免阻塞主线程：

  DispatchQueue.global().async {
      // 解析数据逻辑
      DispatchQueue.main.async {
          // 更新UI
      }
  }
  

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