GKE环境下Socket.io已连接但服务端未触发connection事件问题

问题根因 #

• Redis adapter状态残留：Pod缩容到0时，原有实例在Redis中注册的连接、命名空间、适配器实例信息未被正常清理。新Pod启动后适配器会先同步旧状态，导致动态命名空间的connection事件绑定逻辑被阻塞，此时TCP握手虽然完成（客户端显示连接成功），但事件回调未被正确触发。
• 动态命名空间初始化冲突：如果动态命名空间是收到连接请求时才创建，Redis adapter未完成状态同步时，新连接会被判定为属于已存在的旧命名空间，不会重新执行初始化逻辑，也不会注册connection事件回调。
• 粘性会话缓存冲突：Ingress的粘性Cookie对应旧Pod的会话ID被客户端和Redis缓存，新Pod没有对应会话上下文，握手阶段直接跳过connection事件的触发流程。

修复方案 #

• 增加Pod优雅退出逻辑：在Pod收到SIGTERM信号时，主动调用adapter.close()清理该实例在Redis中的所有注册信息，避免状态残留。
• 开启Redis adapter自动清理配置：初始化适配器时开启purgeOnConnect参数，新Pod启动后自动清理Redis中不属于当前实例的旧状态，配置示例：

const { Server } = require("socket.io");
const { createAdapter } = require("@socket.io/redis-adapter");
const { createClient } = require("redis");

const io = new Server(3000);
const pubClient = createClient({ url: "redis://<你的Redis服务地址>" });
const subClient = pubClient.duplicate();

io.adapter(createAdapter(pubClient, subClient, {
  purgeOnConnect: true // 开启启动时清理旧状态
}));

• 优化动态命名空间初始化逻辑：新增兜底判断，无论命名空间是否已存在，都重新绑定一次connection事件回调，或者给命名空间增加显式的初始化完成标记，避免事件绑定丢失。
• 调整Ingress粘性会话配置：将粘性会话的过期时间设置为小于Socket.io的会话超时时间，避免旧的粘性Cookie路由到已经销毁的Pod实例。
• 新增事件埋点排查：监听Socket.io的new_namespace事件，确认动态命名空间创建和事件绑定流程是否正常执行。

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