GCP App Engine柔性环境Socket.IO wss连接失败回退HTTPS轮询

1. 修复app.yaml配置错误 #

现有配置存在两个核心问题：

• YAML缩进不合法：manual_scaling下的instances、network下的session_affinity没有正确缩进，会导致配置完全不生效
• 缺少WebSocket必需的开关：GAE柔性环境默认不会转发WebSocket升级请求，必须显式开启WebSocket支持
  修正后的完整配置：

runtime: nodejs
env: flex
# 显式开启WebSocket支持
websocket: true
network:
  # 注意子配置需缩进2空格，开启会话亲和保证同一用户连接到同一实例
  session_affinity: true
manual_scaling:
  instances: 1

2. 调整服务端Socket.io配置适配GAE代理 #

GAE柔性环境的HTTPS终止在前置负载均衡层，负载均衡和后端实例走HTTP通信，需要显式配置信任代理，否则会出现协议判定错误导致wss握手失败。
修改Socket.io初始化代码，补充代理和传输配置：

const server = require('http').Server(app);
// 信任GAE前置代理，避免协议识别错误
server.set('trust proxy', true);
const io = require("socket.io")(server, {
  cors: {
    origin: process.env.clienturl,
    credentials: true,
  },
  allowEIO3: true,
  // 显式指定传输方式，优先使用WebSocket
  transports: ['websocket', 'polling']
});

3. 修正Angular客户端连接配置 #

控制台报错中wss://后地址为空，优先排查客户端连接参数：

• 不要手动拼接wss://前缀，直接传入服务端完整HTTPS域名即可，Socket.io客户端会自动完成协议升级
• 传输配置和服务端对齐，显式开启跨域凭证
  参考客户端初始化代码：

import { io } from 'socket.io-client';

// 传入完整的服务端HTTPS地址，不要留空、不要在生产环境用相对路径
const socket = io('https://你的服务端域名', {
  transports: ['websocket', 'polling'],
  withCredentials: true,
  query: {
    uid: '当前登录用户ID'
  }
});

4. 修复现有代码逻辑bug #

当前代码的断开事件监听位置错误，会导致断开的socket无法从映射表中清理，引发内存泄漏和消息投递错误。将disconnect监听移到connection回调内部，同时修正同用户多端登录的逻辑：

io.on('connection', socket => {
  let uid = socket.handshake.query.uid;

  if (!userSocketIdMap.has(uid)) {
    userSocketIdMap.set(uid, new Set([socket.id]));
  } else {
    // 原逻辑直接覆盖Set会导致同用户多端登录仅保留一个连接，改为追加
    userSocketIdMap.get(uid).add(socket.id);
  }

  console.log('client connected', process.env.clienturl, userSocketIdMap)

  // 断开事件必须绑定到单个socket实例上
  socket.on('disconnect', () => {
    console.log('Got disconnect!', socket.id);
    const userSockets = userSocketIdMap.get(uid);
    if (userSockets) {
      userSockets.delete(socket.id);
      if (userSockets.size === 0) {
        userSocketIdMap.delete(uid);
      }
    }
  });
});

5. 部署后验证步骤 #

• 部署完成后先查看GAE实例日志，确认服务正常监听8080端口，无配置加载错误
• 打开浏览器开发者工具-网络面板，筛选WS类型请求，查看握手请求状态码：返回101 Switching Protocols即代表WebSocket连接成功；如果返回4xx/5xx错误，根据响应提示排查CORS或权限配置
• 确认GAE实例前没有额外配置WAF/CDN拦截Connection: Upgrade请求头

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