Socket.io TypeError问题：服务器部署后连接时触发未定义属性赋值错误

问题根源 #

报错直接指向Socket.io Admin UI代码尝试修改socket.data._admin但该属性不存在。核心原因是你的中间件直接覆盖了Socket.io原生的socket.data对象：原本socket.data是Socket.io内部维护的对象，包含Admin UI依赖的_admin属性，但你把它替换成了从Map获取的自定义data，导致Admin UI找不到所需属性。

本地开发时未触发问题，大概率是因为你本地没有启用Socket.io Admin UI，所以不会执行访问_admin的逻辑；部署后启用了Admin UI，这个冲突就暴露了。

修复方案 #

不要直接覆盖socket.data，而是将自定义数据添加到原生的socket.data对象中，保留原对象结构。修改后的中间件代码如下：

// middleware is executed on every request
var Map = require('./file')

module.exports = (io, socket) => {
    socket.use(async (packet, next) => {
        var key = socket.handshake.auth.key
        var data = Map.get(key)   
    
        while(!data.action) {   // true for finished or false for loading
            await new Promise(resolve => setTimeout(resolve,10))
        }

        // 扩展原生socket.data对象，而非直接替换
        Object.assign(socket.data, data);
        // 若不想合并所有属性，也可单独挂载：socket.data.customData = data;
        next()
    })
}

额外说明 #

如果你的业务代码已经依赖直接访问socket.data的逻辑，记得同步调整业务代码（比如改成socket.data.customData，如果用单独挂载的方式），确保逻辑一致性。

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