如何通过日志定位 Debian Node.js 错误

定位思路总览

• 先明确日志来源：应用自身日志、systemd 服务日志、系统日志、内核日志。
• 再按“先近后远、先新后旧”的顺序查看：先看应用最新输出，再看服务与系统日志，最后看内核与硬件相关线索。
• 结合日志级别（如 error、warn、info、debug）与结构化字段（时间、级别、请求ID、堆栈）快速缩小范围。

常用日志位置与查看命令

高效筛选与分析命令

• 实时查看应用日志：tail -f /path/to/app.log
• 关键字定位错误：grep -i ‘error|exception|fail’ /path/to/app.log
• 按时间窗口筛选（假设日志含 ISO 时间前缀）：awk ‘/2026-01-01 10:2[0-9]/’ app.log | grep -i error
• 统计高频错误：grep -i error app.log | sort | uniq -c | sort -nr | head
• 查看崩溃附近上下文：grep -n -A5 -B5 ‘FATAL|UnhandledError’ app.log
• 结构化 JSON 日志提取字段（示例提取 level 与 message）：
  • 简单：jq -r ‘.level + " " + .message’ app.log
  • 时间范围：jq ‘select(.timestamp >= “2026-01-01T10:00:00Z” and .level==“error”)’ app.log
• 结合 systemd 精确定位服务：journalctl -u nodeapp.service -S “2026-01-01 10:00:00” -U “2026-01-01 10:10:00” -e 这些命令可快速从海量日志中捞出关键错误、异常堆栈与高频问题。

常见错误场景与定位路径

• 服务无法启动或反复重启
  • 看服务日志：journalctl -u nodeapp.service -b --no-pager
  • 看应用日志与控制台输出：tail -n50 logs/*.log
  • 看系统日志是否有启动失败、权限/依赖报错：grep -i node /var/log/syslog
• 内存泄漏或 OOM
  • 看内核日志：dmesg | grep -i ‘oom|kill’
  • 结合应用日志的错误堆栈与时间线，定位泄漏路径与触发操作
• 依赖或端口冲突
  • 系统日志/服务日志中的 EADDRINUSE、权限拒绝、模块缺失等关键字
  • 检查端口占用：ss -ltnp | grep 3000 或 lsof -iTCP:3000 -sTCP:LISTEN
• 请求异常但进程未崩溃
  • 若用 Express + Morgan/Winston，重点查 access/error 日志与未捕获异常中间件
  • 在日志中加入 reqId、userId 等上下文，便于串联同一次请求的全链路日志

日志治理与预防建议

• 使用结构化日志（如 Winston/Pino/Bunyan），统一输出 timestamp、level、msg、err、reqId 等字段，便于检索与聚合。
• 合理设置日志级别：生产以 info/error 为主，排障时临时提升到 debug。
• 配置日志轮转与保留策略（如 logrotate），避免磁盘被撑满：
  • 示例（/etc/logrotate.d/nodejs）：
    • /var/log/myapp/*.log { daily; rotate 7; missingok; notifempty; compress; create 0644 app app; }
• 集中式日志与告警：接入 ELK/Graylog 或 Datadog/New Relic，对 error/fatal 建立可视化与阈值告警。
• 稳定性增强：增加 uncaughtException/ unhandledRejection 全局捕获与优雅关闭，确保错误被记录且资源可释放。