部署至Google Cloud Run后Socket.io客户端连接即因传输错误断开

问题概述 #

我开发的Web应用后端基于Python Flask框架，用Flask-SocketIO实现WebSocket连接；前端采用React框架搭配socket.io-client库。本地开发阶段一切正常，但部署到Google Cloud Run服务后，出现Socket客户端成功连接后立即进入每几秒断开并重连的循环问题。

该问题表现具有随机性：有时连接无异常，有时仅短暂断开1-2次，有时会持续约20秒（约10次断开循环）后停止，之后可正常通信。断开重连期间无法通过WebSocket进行数据交互。

客户端错误信息 #

我在客户端添加了断开监听代码：

socketio.on('disconnect', (reason, details) => {
      console.log('Disconnected', reason);
      console.log(details.message);
      console.log(details.description);
      console.log(details.context);
    })

运行后输出的错误详情：

Disconnected transport error
xhr post error
400
XMLHttpRequest {readyState: 4, timeout: 0, withCredentials: false, upload: XMLHttpRequestUpload, onreadystatechange: ƒ, …}

同时控制台出现副作用错误：

WebSocket connection to '<URL>' failed: WebSocket is closed before the connection is established.
GET https:/backendurl/socket.io/?EIO=4&transport=polling&t=P88aKpu&sid=Iu5r6Lfn-b0Uh4ISAAD8 400 (Bad Request)

网络状态说明 #

• 问题出现时：网络请求中存在失败的WebSocket连接请求，伴随多个返回400状态码的polling请求
• 正常连接时：存在pending状态的101协议切换请求，表明WebSocket已成功建立连接

排查与解决方案建议 #

• 开启Cloud Run会话亲和性：Cloud Run默认不启用会话亲和，SocketIO需要同一客户端的请求路由到同一个后端实例。部署时添加--session-affinity标志，确保客户端与实例保持绑定。
• 端口与服务配置：后端服务需监听0.0.0.0，端口使用Cloud Run提供的PORT环境变量；Flask-SocketIO初始化时正确配置CORS，允许前端Cloud Run域名访问。
• 版本兼容性检查：确保后端Flask-SocketIO与前端socket.io-client版本匹配（建议使用同一系列版本，如均为4.x），版本不匹配会导致握手失败。
• 调整Ping/Pong超时设置：在Flask-SocketIO中配置ping_timeout和ping_interval，避免Cloud Run负载均衡因长时间无数据传输断开连接。示例：

  socketio = SocketIO(app, cors_allowed_origins="前端域名", ping_timeout=60, ping_interval=25)
  

• 强制WebSocket传输：客户端初始化Socket时指定仅使用WebSocket传输，跳过可能出错的polling阶段：

  const socket = io('后端URL', { transports: ['websocket'] });
  

• 验证CORS配置：确保后端CORS设置包含前端完整域名，若需要携带凭证，需设置withCredentials: true并对应配置后端的cors_allowed_origins和credentials选项。

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