Postman Socket.IO连接UI访问本地服务报错404无法连接问题排查

报错信息如下：

Could not connect to localhost:3000
17:02:53
Error: Unexpected server response: 404
Handshake Details
Request URL: http://localhost:3000/socket.io/?EIO=3&transport=websocket
Request Method: GET
Status Code: 404 Not Found

本地连接失败的核心原因是Postman默认向监听3000端口的Express服务发起Socket.IO握手请求，但你的Socket.IO服务实际绑定在443端口，3000端口无对应Socket.IO处理逻辑，因此返回404错误。

具体排查步骤 #

• 修正Postman连接地址：将原连接地址http://localhost:3000替换为Socket.IO服务实际监听的地址http://localhost:443（若为HTTPS协议则替换为https://localhost:443），不要使用Express服务的3000端口发起Socket.IO连接请求。
• 校验本地443端口监听状态：执行对应系统命令查看443端口是否被Socket.IO服务正常占用，Windows系统执行netstat -ano | findstr "443"，Mac/Linux系统执行lsof -i:443；如果端口被其他进程占用，先终止冲突进程再重启Socket.IO服务。
• 匹配Socket.IO版本：报错中EIO=3对应Socket.IO v2.x版本，如果本地部署的Socket.IO服务为v3.x及以上版本，EIO对应值为4，需要在Postman连接参数中修改EIO值为4，或者将本地Socket.IO服务降级到v2.x版本，避免版本不兼容导致握手失败。
• 检查本地跨域配置：确认本地Socket.IO服务的跨域规则允许Postman的请求源访问，可临时关闭跨域校验后重试连接，排除跨域拦截导致的404问题。
• 对齐EC2部署配置：逐一对比本地和EC2上的Socket.IO服务配置，包括端口绑定规则、路径前缀、跨域配置、服务版本，确保本地配置和EC2可正常连接的配置完全一致。

内容的提问来源于stack exchange，提问作者MUHAMMAD SHAHID RAFI C P