Socket.IO无法连接问题：服务启动但未触发连接日志

启动服务器后仅能看到Server is running on port 3009的控制台日志，但Socket.IO的connection事件完全没触发，无法打印“Socket connection is ready!”和socket id，核心原因是服务端仅完成了监听配置，但没有客户端主动发起Socket.IO连接请求。

以下是具体解决步骤：

1. 添加客户端连接页面 #

在项目根目录创建public文件夹，里面新建index.html文件，写入客户端连接逻辑：

<!DOCTYPE html>
<html>
<head>
  <title>Socket.IO 连接测试</title>
  <!-- 直接通过服务端暴露的路径引入Socket.IO客户端库 -->
  <script src="/socket.io/socket.io.js"></script>
  <script>
    // 发起与服务端的Socket.IO连接
    const socket = io();
    socket.on('connect', () => {
      console.log('客户端已连接，socket id:', socket.id);
    });
  </script>
</head>
<body>
  <h1>Socket.IO 连接测试页面</h1>
</body>
</html>

2. 配置Express静态文件服务 #

在服务端代码中添加静态文件服务配置，让Express能访问public目录下的文件：

// 在const app = express();之后添加这行代码
app.use(express.static('public'));

3. 验证连接 #

重启服务器，打开浏览器访问http://localhost:3009，此时客户端会自动向服务端发起Socket.IO连接，服务端控制台就能看到预期的Socket connection is ready!以及对应的socket id了。

额外排查要点 #

• 确保服务端与客户端的Socket.IO版本完全一致，版本不兼容会导致连接失败
• 如果是跨域场景，需要在Socket.IO服务端初始化时配置跨域允许：

  const io = new Server(httpServer, {
    cors: {
      origin: "http://你的客户端域名",
      methods: ["GET", "POST"]
    }
  });
  

• 检查防火墙、代理是否拦截了WebSocket连接请求

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