Node.js在CentOS上的错误日志怎么分析

Node.js 在 CentOS 上的错误日志分析指南

一 日志来源与定位

• 系统服务日志：若通过 systemd 托管（服务单元名如 your-nodejs.service），使用命令查看与跟踪：
  • 查看全部日志：sudo journalctl -u your-nodejs.service -b
  • 实时跟踪：sudo journalctl -u your-nodejs.service -f
  • 按时间过滤：sudo journalctl -u your-nodejs.service --since "2025-12-15 10:00:00" --until "2025-12-15 12:00:00"
• 应用输出日志：若启动时重定向输出到文件（如 node app.js > logs/app.log 2>&1 &），使用命令检索与跟踪：
  • 实时查看：tail -f logs/app.log
  • 关键字过滤：grep -i 'error\|exception\|fatal' logs/app.log
  • 分页浏览：less -S logs/app.log
• 第三方日志：如使用 PM2，可用 pm2 logs 查看与过滤；如使用 Winston/Pino/Bunyan 等结构化日志库，日志多为 JSON 格式，便于后续检索与聚合。

二 命令行高效排查

• 快速定位高频错误：统计错误出现次数并排序
  • grep -io 'error\|exception\|fatal' logs/app.log | sort | uniq -c | sort -nr | head
• 按时间窗口查看：先定位首次报错时间，再查看前后上下文
  • grep -n "2025-12-15 10:23" logs/app.log 获取行号，再用 sed -n '1000,1050p' logs/app.log 查看片段
• 追踪最新错误并高亮堆栈：结合 tail 与 grep
  • tail -n 200 logs/app.log | grep -A 20 -B 5 -i 'error'
• 结构化日志解析（JSON）：提取字段并筛选
  • jq 'select(.level=="error") | {time:.timestamp, msg:.message, stack:.stack}' logs/app.log
• 系统资源关联：当日志出现间歇性失败，联动系统指标
  • top/htop、vmstat 1、iostat -x 1 检查 CPU/内存/IO 瓶颈。

三 常见错误模式与处理要点

• 端口占用：Error: listen EADDRINUSE: address already in use :::3000
  • 处理：ss -ltnp | grep :3000 或 lsof -i :3000 找到 PID 后 kill -9 <PID>；或调整应用端口。
• 模块缺失：Error: Cannot find module 'xxx'
  • 处理：确认 node_modules 完整，执行 npm install；检查 NODE_PATH 与相对路径。
• 权限问题：Error: EACCES, permission denied
  • 处理：核对日志目录/文件的 用户与权限；必要时 chown/chmod 或以具备权限的用户运行。
• 地址不可用：Error: EADDRNOTAVAIL
  • 处理：确认绑定的 IP 在本机网卡上存在且可用，避免绑定不存在的地址。
• 连接超时：Error: ETIMEDOUT
  • 处理：检查目标服务可达性、网络与 防火墙 策略，必要时增加 超时 配置。
• 未处理的异常/拒绝：出现 uncaughtException/unhandledRejection
  • 处理：增加全局监听并记录堆栈，必要时安全退出并重启；在 Express 中使用统一错误处理中间件。

四 结构化日志与长期治理

• 采用结构化日志库：如 Winston/Pino/Bunyan，统一日志 level、timestamp 与 message，便于检索与聚合；示例（Winston）：
  • logger.info('startup', { port: 3000 }); logger.error('db fail', { err: err.message, stack: err.stack });
• 日志轮转与保留：使用 winston-daily-rotate-file 或 logrotate 控制单文件大小与保留天数，避免磁盘被占满。
• 集中式日志：引入 ELK Stack（Elasticsearch/Logstash/Kibana）、Fluentd 或 Graylog，实现多实例日志的采集、分析与可视化。

五 最小可行排错流程

• 复现与定位：先看最近 5–10 分钟日志 tail -n 200 app.log | grep -i error；若是服务，优先 journalctl -u your-nodejs.service -f。
• 错误类型分流：端口/权限/网络类错误先修复运行环境问题；模块缺失类错误恢复依赖；出现 uncaughtException/unhandledRejection 先加全局监听与堆栈记录，再修复根因。
• 资源与依赖核查：联动 top/htop、vmstat 检查 CPU/内存/IO；确认 Node.js/npm 版本与依赖一致；必要时回滚近期变更。
• 加固与预防：接入 结构化日志与轮转；为关键异常增加 告警；在 systemd 中配置 Restart=on-failure 并持久化 journal 日志，便于事后取证。