部署到Google Cloud App Engine的Node.js Socket.IO粘性会话问题咨询

1. 优先确认App Engine运行环境配置 #

• 必须使用App Engine Flex环境，标准环境默认不支持WebSocket协议，无法运行Socket.IO
• 在你的app.yaml中添加以下配置：

runtime: nodejs
env: flex
# 开启会话亲和性，匹配Socket.IO的会话要求
network:
  session_affinity: true
# 放开WebSocket升级所需的配置
handlers:
  - url: /.*
    script: auto
    websocket: true

• 确保Node.js服务监听地址为0.0.0.0，端口读取环境变量process.env.PORT，不要写死本地端口：

const PORT = process.env.PORT || 3000;
server.listen(PORT, '0.0.0.0', () => {
  console.log(`server running on port ${PORT}`);
});

2. 修正Socket.IO服务端配置 #

Redis Adapter配置错误修正 #

你当前将完整的REDISTOGO_URL赋值给了host字段，该字段仅接受主机地址，不支持带协议的完整连接串，修改为以下两种方式二选一：

// 方式1：直接传入完整连接串
io.adapter(redisAdapter(process.env.REDISTOGO_URL));

// 方式2：单独传配置项，host仅填主机地址
io.adapter(
  redisAdapter({
    host: "你的Redis主机地址（不含redis://协议和端口、密码）",
    port: 15156,
    password: process.env.REDIS_PASSWORD,
  })
);

Sticky Session配置补全 #

你目前只调用了setupWorker(io)，集群模式下必须在master进程中补充调用setupMaster(server)，否则sticky会话不生效：

// 仅在master进程中执行
if (cluster.isPrimary) {
  setupMaster(server, {
    loadBalancingMethod: "least-connection",
  });
  // 后续启动worker的逻辑
}

3. 网络连通性校验 #

• 如果使用的是谷歌云Redis实例，确认Redis实例和App Engine在同一个VPC网络，且VPC防火墙已放开15156端口的入站规则
• 如果使用第三方Redis服务，将App Engine的出口IP段添加到Redis服务的访问白名单中
• 排查阶段可临时简化CORS配置，避免规则错误导致拦截：

cors: {
  origin: true,
  credentials: true
}

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