Express.js 3.21频繁触发请求实体过大错误，如何排查请求内容？

针对Express 3.21版本中频繁出现的「request entity too large」错误，要捕获超出限制的请求内容，需要在body-parser处理请求前添加自定义逻辑——因为默认的express.bodyParser()会在请求大小超限时直接抛出错误，不会留存请求内容。以下是具体实现方案：

1. 在body-parser前添加自定义中间件 #

在你的app.use(express.bodyParser(...))配置之前插入以下中间件，提前拦截并记录大请求的关键信息：

// 拦截大请求的中间件，必须放在body-parser之前
app.use(function(req, res, next) {
  const maxAllowedSize = 200 * 1024; // 和body-parser的限制保持一致（200kb）
  const contentLength = req.headers['content-length'];

  // 提前判断请求大小是否超限
  if (contentLength && parseInt(contentLength) > maxAllowedSize) {
    let rawBodyChunk = '';
    const maxLogLength = 500; // 仅记录前500字符，避免内存溢出

    // 读取请求流片段
    req.on('data', (chunk) => {
      rawBodyChunk += chunk.toString();
      // 防止恶意请求耗尽内存，超过1MB就终止读取
      if (rawBodyChunk.length > 1024 * 1024) {
        req.destroy();
      }
    });

    req.on('end', () => {
      // 打印关键信息：IP、请求方法、路径、内容长度、请求体片段
      console.error(`[LARGE REQUEST] IP: ${req.ip}, Method: ${req.method}, Path: ${req.path}, Content-Length: ${contentLength}`);
      console.error(`[BODY SNIPPET] ${rawBodyChunk.slice(0, maxLogLength)}${rawBodyChunk.length > maxLogLength ? '...' : ''}`);
      // 继续抛出错误，保持原有错误处理逻辑
      next(new Error('request entity too large'));
    });

    req.on('error', (err) => {
      console.error(`[FAILED TO READ LARGE REQUEST] ${err.message}`);
      next(err);
    });
  } else {
    // 请求大小正常，交给后续中间件处理
    next();
  }
});

// 原有的body-parser配置
app.use(express.bodyParser({limit: '200kb'}));

2. 结构化日志优化（可选） #

如果需要更方便的日志分析，可以将输出改为JSON格式，适配日志收集工具：

// 替换console.error为结构化输出
console.error(JSON.stringify({
  timestamp: new Date().toISOString(),
  type: 'large_request',
  ip: req.ip,
  method: req.method,
  path: req.path,
  content_length: contentLength,
  body_snippet: rawBodyChunk.slice(0, maxLogLength)
}));

3. 内存安全注意事项 #

• 不要完整读取超大请求体，设置最大读取长度（示例中为1MB），避免被DDoS攻击耗尽服务器内存。
• 仅记录请求体的片段内容，足够判断请求性质即可，无需存储完整数据。

4. 反向代理层补充记录（可选） #

如果你的服务前端有Nginx等反向代理，可以在代理层直接记录大请求信息，即使Node.js服务异常也能留存数据：

# Nginx配置示例：单独记录超过200kb的请求
log_format large_requests '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $content_length';
access_log /var/log/nginx/large_requests.log large_requests if=$request_length_gt_204800;

通过以上方法，你可以获取触发错误的请求的IP、路径、请求体片段等信息，判断是否为恶意DDoS攻击，进而采取针对性的防护措施。

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