NodeJS+Socket.io未知客户端连接未处理错误致服务崩溃求助

错误原因分析 #

你遇到的HPE_INVALID_METHOD错误，是Node.js HTTP服务器解析到不符合规范的请求格式导致的。从报错的rawPacket内容能看到，是外部扫描器或机器人发送了异常的POST /GponForm/diagn_Form?images/ HTTP/1.1请求——这类请求不是Socket.io的合法握手请求，触发了底层Socket的error事件，但因为没捕获该事件，直接导致进程崩溃。

你之前加的try/catch没用，因为io.sockets.on('connection')是同步注册事件监听的操作，而错误是在后续处理连接的异步流程中抛出的，根本抓不到。

具体修复步骤 #

1. 给HTTP服务器添加全局错误监听 #

直接在创建的server实例上监听error事件，捕获底层Socket的错误，避免进程崩溃：

var express = require('express')
var app = express()
var server = require('http').createServer(app)
var io = require('socket.io')(server);

// 新增：捕获HTTP服务器的底层错误，防止进程崩溃
server.on('error', (err) => {
  console.error('HTTP服务器错误:', err);
  // 这里可以写日志，不用中断进程
});

// 新增：捕获Socket.io底层引擎的错误
io.engine.on('error', (err) => {
  console.error('Socket.io引擎错误:', err);
});

connections = []

server.listen(80)
console.log('running')

// 原有业务代码保持不变
app.get('/', function (req, res) {
    res.sendFile(__dirname + '/index.html')
})

io.sockets.on('connection', function (socket) {
    // ... 原有连接处理逻辑
})

2. （可选）提前拦截无效请求 #

如果想减少这类无效请求的干扰，可以在Express中间件里过滤非Socket.io的请求：

app.use((req, res, next) => {
  // 只允许根路径请求和Socket.io握手请求
  if (req.path === '/' || (req.headers.upgrade && req.headers.upgrade.toLowerCase() === 'websocket')) {
    return next();
  }
  // 其他请求直接返回404，避免触发解析错误
  res.sendStatus(404);
});

修复原理 #

Node.js里，任何EventEmitter实例抛出的未处理error事件都会导致进程崩溃。HTTP服务器的底层Socket属于EventEmitter，当解析错误发生时会触发error事件，只要我们主动捕获并处理（比如打印日志），进程就不会崩溃。同时监听Socket.io引擎的错误，能覆盖更多异步场景下的异常。

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