Debian Node.js日志中HTTP状态码含义

Debian 上运行的 Node.js 服务日志中，HTTP 状态码用于指示请求在客户端与服务器之间的处理结果。状态码为三位数字，按首位划分为 1xx–5xx 五类，含义固定且与语言/框架无关。

状态码分类概览

• 1xx 信息性：请求已被接收，继续处理（如：100 Continue、101 Switching Protocols）。
• 2xx 成功：请求已成功接收、理解并处理（如：200 OK、201 Created、204 No Content）。
• 3xx 重定向：需要额外操作以完成请求（如：301 Moved Permanently、302 Found、304 Not Modified）。
• 4xx 客户端错误：请求存在语法错误或无法完成（如：400 Bad Request、401 Unauthorized、403 Forbidden、404 Not Found、405 Method Not Allowed）。
• 5xx 服务器错误：服务器处理请求时发生错误（如：500 Internal Server Error、502 Bad Gateway、503 Service Unavailable、504 Gateway Timeout）。

常见状态码与排查要点

在 Node.js 与 Express 中设置与记录

• 设置状态码（原生 http 模块）：

  const http = require('http');
      
  const server = http.createServer((req, res) =>
   {
  
    res.writeHead(200, {
   'Content-Type': 'text/plain' }
      );
      
    res.end('OK');
  
  }
      );
      
  server.listen(3000, () =>
       console.log('Server on 3000'));
      
  

• 设置状态码（Express）：

  app.get('/ok', (req, res) =>
       res.status(200).send('OK'));
      
  app.get('/created', (req, res) =>
   res.status(201).json({
   id: 1 }
      ));
      
  app.use((err, req, res, next) =>
   {
      
    console.error(err);
       // 便于 Debian 系统日志/服务日志排查
    res.status(500).send('Internal Server Error');
  
  }
      );
      
  

• 日志建议：在 Nginx 记录响应码（如：access_log /var/log/nginx/access.log; ），在 Node.js 统一使用 Morgan 或自定义中间件输出 statusCode、method、url、responseTime、ip，便于在 journald/syslog 中检索与告警。

Debian 环境排查要点

• 定位进程与日志：确认服务由 PM2/Node/npm 启动，查看 journalctl -u your-service 或 /var/log/…；Nginx 访问与错误日志分别位于 /var/log/nginx/access.log 与 error.log。
• 区分 4xx 与 5xx：大量 4xx 多为客户端/路由问题；持续 5xx 需优先排查未捕获异常、依赖服务不可用、资源耗尽（CPU/内存/句柄/连接）。
• 网关链路：若经 Nginx/负载均衡，出现 502/504 优先检查上游进程存活、超时与反向代理配置；503 常见于进程崩溃或维护模式。
• 缓存与重定向：304 属正常命中；301/302 需核对 SEO 与跳转目标是否正确配置。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！