使用nodemon启动Socket.io服务器无连接日志，请求排查问题

1. 检查server.js基础结构是否正确 #

socket.io无法独立运行，必须依附于HTTP服务器，新手常犯的错误是仅初始化socket.io却未启动HTTP服务。正确的基础示例代码如下：

const http = require('http');
const { Server } = require('socket.io');

const server = http.createServer();
const io = new Server(server, {
  cors: {
    origin: "http://localhost:你的前端端口", // 根据实际前端地址配置跨域
    methods: ["GET", "POST"]
  }
});

io.on('connection', (socket) => {
  console.log('用户已连接');
  // 其他socket逻辑
});

// 关键：必须启动HTTP服务器监听端口，而非socket.io直接监听
server.listen(3001, () => {
  console.log('服务器运行在http://localhost:3001');
});

如果你的代码中缺少server.listen(3001)这一步，服务器根本不会启动，自然不会输出任何日志。

2. 排查语法错误与依赖问题 #

• 跳过nodemon，直接执行node server.js启动服务器，此时终端会直接显示语法错误或依赖缺失信息（nodemon的启动提示可能掩盖错误）。
• 确认所有依赖已安装：执行npm install socket.io nodemon，避免因依赖未安装导致启动失败。

3. 验证nodemon配置与环境 #

你的package.json脚本"devStart": "nodemon server.js"本身无问题，但可以尝试：

• 清除nodemon缓存：执行nodemon --cache-dir /tmp/nodemon-cache server.js，避免缓存异常导致启动卡住。
• 明确指定node执行环境：修改脚本为"devStart": "nodemon --exec node server.js"，确保使用当前项目的node环境。

4. 检查端口占用情况 #

• Mac/Linux执行lsof -i :3001，Windows执行netstat -ano | findstr :3001，查看3001端口是否被其他程序占用。若被占用，可杀掉对应进程或修改server.js中的监听端口。

5. 先测试基础HTTP服务是否正常 #

暂时注释socket.io相关代码，仅保留基础HTTP服务：

const http = require('http');
const server = http.createServer((req, res) => {
  res.end('服务器正常运行');
});
server.listen(3001, () => {
  console.log('服务器运行在3001端口');
});

执行node server.js启动后，检查是否有日志输出，同时在浏览器访问http://localhost:3001查看是否能收到返回内容。若这一步失败，问题出在HTTP服务器基础配置上，与socket.io无关。

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