Socket.IO如何自定义socket.id而非仅修改socket.conn.id

原因说明 #

你修改的io.engine.generateId是Socket.IO底层Engine.IO传输层的ID生成方法，仅作用于底层连接ID（也就是你看到的socket.conn.id），而Socket.IO层的socket.id有独立的生成逻辑，所以改前者不会生效。

正确实现方案 #

方案1：重写Socket.IO层全局ID生成方法（最推荐）

直接修改io.generateId而非io.engine.generateId，即可全局自定义所有socket.id的生成规则：

io.generateId = (req) => {
    // 此处返回你自定义的ID即可，必须保证全局唯一
    return 13543; 
}
io.on("connection",(socket)=>{
    console.log(socket.id) // 此时会输出你自定义的 13543
})

如果仅需要针对单个命名空间自定义ID，重写对应命名空间的generateId方法即可：

// 示例：为/test命名空间单独配置ID生成规则
const testNamespace = io.of("/test");
testNamespace.generateId = (req) => {
    return "test_" + 自定义ID逻辑;
}

方案2：连接建立后手动覆盖ID（适合需要动态指定ID的场景）

如果需要在连接建立、拿到用户信息后再动态指定ID，可以在connection事件中手动修改socket.id，同时同步内部的ID映射：

io.on("connection",(socket)=>{
    // 先删除旧ID的映射关系
    io.sockets.sockets.delete(socket.id);
    // 赋值自定义ID
    socket.id = 13543;
    // 写入新ID的映射关系
    io.sockets.sockets.set(socket.id, socket);

    console.log(socket.id) // 输出13543
})

注意：使用方案2时如果部署了多实例Socket.IO服务、用到了跨实例适配器（如Redis适配器），需要同步更新适配器内的ID映射，否则会出现私聊、广播消息投递失败的问题。

注意事项 #

自定义ID必须保证全局唯一，否则会出现连接冲突、消息错发的问题。

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