Debian 上 Node.js 日志错误追踪的实用技巧
一 快速定位日志来源
- 应用日志：优先查看应用写入的日志文件或标准输出。若使用日志库（如 winston、morgan、bunyan、pino），检查其配置的输出路径与文件名；Express 常见为 error.log。
- 系统日志：Node 进程或系统服务常写入 /var/log/syslog；部分系统也可能写入 /var/log/messages。
- 服务日志：使用 systemd 管理的服务，用 journalctl -u your-app.service 查看。
- 内核与启动日志：硬件/驱动/崩溃线索可用 dmesg | grep -i node。
- 自定义目录：部分应用约定在 /var/log/nodejs/，以实际配置为准。
二 高效筛选与实时监控
- 实时查看文件：tail -f /path/to/app.log 或 tail -F（自动重连）。
- 关键词检索：grep -i “error|exception|fail” /var/log/syslog；结合正则精确匹配堆栈或请求 ID。
- 按时间窗口：journalctl -u nodeapp.service --since “2025-04-01 10:00:00” --until “2025-04-01 12:00:00”。
- 多文件跟踪：tail -f /var/log/nodejs/*.log。
- 高亮与去重：less -S +G（翻页查看），配合 grep -A/-B/-C 显示上下文。
三 应用侧日志最佳实践
- 使用成熟日志库：如 winston、pino、bunyan、morgan；生产建议结构化输出（JSON），便于检索与聚合。
- 合理日志级别：区分 DEBUG/INFO/WARN/ERROR/FATAL；生产默认 WARN/ERROR，问题排查时临时开启 DEBUG。
- 多目标输出：同时输出到控制台与文件；错误单独写入 error.log，全量写入 combined.log。
- 异常兜底：务必监听 uncaughtException、unhandledRejection，在退出前记录关键上下文，避免静默崩溃。
- 调试辅助：本地或复现环境可用 DEBUG=* 开启模块调试日志；远程问题可接入 Sentry 等错误监控。
四 日志轮转与保留策略
- 系统级 logrotate（推荐）：创建 /etc/logrotate.d/nodejs-app，示例：
/path/to/your/nodejs/app/*.log {
daily
rotate 7
compress
missingok
notifempty
create 0640 root adm
}
校验与强制执行：logrotate -d /etc/logrotate.conf（语法检查），logrotate -f /etc/logrotate.conf（强制执行）。
- 应用级轮转：使用 winston-daily-rotate-file，按天/大小切分并压缩归档，便于保留策略与性能稳定。
五 集中化与性能优化
- 集中式日志：搭建 ELK Stack（Elasticsearch、Logstash、Kibana） 或 Graylog，统一采集、检索、可视化与告警。
- 结构化与采样：统一时间戳、请求 ID、服务名等字段；高流量时对非关键 DEBUG 采样，降低开销。
- 异步与非阻塞：采用异步写入或高性能日志库，避免 I/O 阻塞事件循环。
- 接入 syslog：将应用日志发送至 rsyslog/syslog-ng，统一系统日志治理。
- 监控与告警：结合 Sentry 等错误追踪与 ELK 告警规则，缩短 MTTR。