如何利用Ubuntu Node.js日志进行故障排除

Ubuntu 上用 Node.js 日志做故障排除的实操流程

一 定位日志来源与快速查看

• 应用日志
  • 常见位置：项目根目录的 app.log、error.log 或配置文件（如 config.json、settings.js）中指定的路径。
  • 实时查看：tail -f /path/to/your.log；按关键字过滤：grep -i ‘Error’ /path/to/your.log。
• 进程管理日志
  • 使用 PM2：pm2 logs 查看全部；pm2 logs < app_name_or_id> 查看单个应用；pm2 logs --lines 1000 查看最近 1000 行；pm2 logs --follow 实时跟踪；可按级别筛选：pm2 logs your-app --lines 50 | grep WARN。
• 系统与服务日志
  • 系统日志：sudo tail -f /var/log/syslog；服务日志：sudo journalctl -u < service_name> ；内核与硬件相关：/var/log/kern.log、/var/log/dmesg。

二 常见错误模式与对应处置

• 未处理的 Promise 拒绝
  • 现象：(node:5678) UnhandledPromiseRejectionWarning
  • 处置：为所有 Promise 加 .catch()；在 async 函数中使用 try-catch；临时兜底：process.on(‘unhandledRejection’, (reason) => console.error(reason))。
• 事件监听器泄漏
  • 现象：MaxListenersExceededWarning
  • 处置：检查重复添加监听；必要时 emitter.setMaxListeners(n) 或移除监听器：emitter.removeListener(‘event’, handler)。
• 内存不足 OOM
  • 现象：FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
  • 处置：短期提升堆上限 node --max-old-space-size=4096 app.js；长期用 clinic/heapdump 分析泄漏并优化数据结构与缓存策略。
• 废弃 API 警告
  • 现象：DeprecationWarning（如 Buffer() 用法）
  • 处置：按警告替换 API（如改用 Buffer.alloc()）；升级依赖与 Node 运行时，避免依赖链中的旧实现。

三 网络类问题的日志定位

• 先看应用日志中的连接超时、ECONNREFUSED、ETIMEDOUT 等关键词，确认是客户端、服务端还是中间件问题。
• 再看系统日志：sudo tail -f /var/log/syslog；必要时检查 /var/log/kern.log、/var/log/dmesg 以排除内核/驱动层异常。
• 做连通性与路径排查：ping 目标主机；traceroute 观察路由跳数与丢包；必要时用 netstat/ss 检查本机端口占用与连接状态。
• 核对防火墙与策略：ufw status 或 iptables -S，确保应用端口（如 3000、80/443）放行；反向代理（如 Nginx）错误可查 /var/log/nginx/error.log。

四 提升日志可观测性的配置建议

• 使用结构化日志库并区分级别与输出目标
  • 建议库：Winston、Bunyan、Pino（JSON 便于检索与聚合）。
  • 示例（Winston）：level 设为 info/debug；transports 同时输出到控制台与文件（如 error.log、combined.log）；加入 timestamp 等元信息。
• 配置合理的日志级别
  • 开发/排障：设为 debug；生产：常用 info/warn/error；避免过细导致磁盘压力，也避免过粗遗漏关键信息。
• 日志轮转与保留策略
  • 按天/按大小切分并压缩归档，保留 7–30 天（合规要求更长时另行规划），防止磁盘被占满导致进程异常。
• 可读性与集中化
  • 开发环境可用 pino-pretty / bunyan-pretty 美化输出；生产建议直接落 JSON，接入 ELK（Elasticsearch、Logstash、Kibana）或 Graylog 做检索、告警与可视化。

五 最小化排障命令清单

• 实时看应用日志：tail -f logs/app.log
• 过滤错误：grep -i ‘Error’ logs/app.log
• PM2 查看与筛选：pm2 logs；pm2 logs --lines 200 | grep WARN
• 系统与服务日志：sudo tail -f /var/log/syslog；sudo journalctl -u < service_name> -f
• 网络连通与路径：ping example.com；traceroute example.com
• 防火墙与端口：ufw status；ss -tulpen | grep 3000
• 内存 OOM 临时处置：node --max-old-space-size=4096 app.js
• 调试与剖析：node --inspect-brk app.js 并在 Chrome 打开 chrome://inspect；npm install -g clinic & & clinic doctor – node app.js

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