Next.js API中res对象属性能否跨请求保留？Socket.io实现疑问

核心结论先明确 #

单个请求的res对象是一次性的，不会在请求间保留，但res.socket.server是Node.js全局的HTTP Server实例，它的属性会在服务器进程生命周期内持续存在。

1. res对象与res.socket.server的本质区别 #

每个HTTP请求触发时，Node.js都会生成全新的req和res对象，请求结束后这些对象会被回收销毁。但res.socket是当前请求对应的TCP连接对象，而res.socket.server指向的是整个应用的全局HTTP Server实例——这个实例从服务器启动时就存在，直到进程终止才会被销毁。

你看到的代码正是利用这一特性：把Socket.io的io实例挂载到全局的HTTP Server上，让所有后续请求都能复用同一个io实例，避免重复创建Socket.io服务。

2. 属性保留的要求 #

• 只要服务器进程不重启，挂载在res.socket.server上的属性就会一直存在。
• 注意Next.js开发环境的热重载机制：每次修改代码后，Next.js会重启服务器进程，此时res.socket.server上的属性会被重置，需要重新初始化Socket.io实例；生产环境下只要进程稳定运行，属性就会持续保留。

3. 是否按客户端区分？ #

完全不会。res.socket.server是全局共享的HTTP Server实例，所有客户端的请求都会访问同一个实例上的io属性。Socket.io本身会通过socket ID来区分不同的客户端连接，全局的io实例负责统一管理所有客户端的连接、广播消息等操作。

结合代码示例再解释 #

import { Server } from "socket.io";

export default function SocketHandler(req, res) {
    if (res.socket.server.io) {
        console.log("Already set up");
        res.end();
        return;
    }
    const io = new Server(res.socket.server);
    // 这里可添加Socket.io事件监听逻辑，比如io.on('connection', ...)
    res.socket.server.io = io;
    res.end();
}

这段代码的核心是单例模式：只在第一个请求进来时创建Socket.io Server实例，后续请求直接复用已创建的实例。如果不做这个检查，每个请求都创建新的io实例，会导致端口冲突、重复监听等问题，完全不符合Socket.io的使用规范。

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