如何在Node.js中实现Socket.IO服务与主服务同服务器运行不崩溃

完全可行，不需要单独启动独立Socket.IO服务，也不会触发端口冲突、服务崩溃问题。
之前必须单独启动服务的核心原因是旧写法里Socket.IO自己调用了listen()方法抢占独立端口，只要把Socket.IO的监听逻辑挂载到主服务持有的原生HTTP服务实例上，就能实现单端口同时承载普通HTTP服务和WebSocket长连接服务。

具体实现（以最常用的Express主服务为例，其他Node.js框架逻辑通用） #

• 第一步：调整主服务启动逻辑，不要让框架隐式创建HTTP服务，先手动拿到原生HTTP Server实例
  旧写法里直接调用app.listen(3000)会让express自己内部创建HTTP实例，拿不到实例就没法挂载Socket.IO，改成显式创建即可：

  const express = require('express');
  const { createServer } = require('node:http');
  const { Server: SocketIOServer } = require('socket.io');
  
  const app = express();
  // 把express的请求处理逻辑挂载到手动创建的HTTP实例上
  const httpInstance = createServer(app);
  

• 第二步：初始化Socket.IO时直接传入已有HTTP实例，不要传独立端口参数
  这一步是避免端口冲突的核心，不要给Socket.IO单独调用listen()，直接复用已有的服务实例：

  const io = new SocketIOServer(httpInstance, {
    // 跨域配置按你实际业务需求调整即可
    cors: { origin: "http://localhost:3000" }
  });
  
  // 之前写的所有Socket.IO业务逻辑不用改，直接放在这里
  io.on('connection', (socket) => {
    console.log('客户端连接成功', socket.id);
    // 消息监听、广播等原有逻辑完全保留
  });
  

• 第三步：主服务原有路由、中间件逻辑不用改动，最后统一用HTTP实例启动3000端口监听

  // 原来的接口、静态资源托管等逻辑和之前写法完全一致
  app.get('/api/xxx', (req, res) => {
    res.send({ code: 0, msg: '主服务响应正常' });
  });
  
  // 只需要调用一次listen，单端口同时承载两种服务
  httpInstance.listen(3000, () => {
    console.log('服务已启动：http://localhost:3000，主服务与Socket.IO共同运行');
  });
  

避坑说明 #

千万不要同时给主服务框架、Socket.IO分别调用listen()方法监听3000端口，所有端口监听逻辑统一交给上面创建的httpInstance处理就不会出现端口占用报错、服务崩溃问题。
服务启动后会自动做请求分流：普通的HTTP接口、页面请求走主服务原有处理逻辑，WebSocket协议升级请求会自动转交给Socket.IO处理，两者运行互不干扰。
如果你的主服务用的是Koa、Fastify等其他Node.js框架，实现逻辑完全一致：只要拿到框架底层暴露的原生HTTP Server实例，把Socket.IO挂载上去再统一启动监听即可。

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