Debian环境下Node.js日志常见问题

在Debian环境下跑Node.js服务，日志问题是最容易让人头疼的。不少新手上来就卡在“日志去哪了”或者“日志写不进去”这类问题上，更别提后续的排查了。今天就从几个高频问题入手，把常见症状、根因和解决方案一次讲清楚。

一 常见症状与快速定位

先确认一下，服务是不是启动失败，端口被占用了？日志里出现 EADDRINUSE 这个提示，意思就是端口被其他进程占了。解决办法也简单，要么换个端口，要么用 lsof 或 ss 找到那个进程干掉它。

权限问题也很常见。日志目录或文件不可写，报 EACCES 错误。这时候要检查目录是否存在、属主和权限对不对，应用是不是以正确的用户身份运行的。

还有一类情况，日志文件突然“消失”或者写入中断了。这很可能是被外部进程删除或移动了。解决方法：监控日志目录的变化，避免外部清理脚本误伤；必要时重建写入流。

日志量暴涨也是个麻烦事。单个日志文件持续增长，迟早把磁盘占满。解决办法很简单：启用按日或按大小轮转，顺便压缩一下。

分析日志时的痛点是内容不统一。格式不统一、缺少时间或级别这些关键字段，排查问题就像大海捞针。建议统一用结构化日志，比如 JSON 格式，规范好字段。

关键错误没记录，这个坑更致命。很多项目图省事只用 console.log，结果级别和输出完全不可控。必须用有级别和传输能力的日志库，比如 Winston、Pino、Bunyan。

高并发下性能下降，往往是因为同步写、频繁字符串拼接、过度打点。异步写、采样降级、选高性能库，这些手段都能派上用场。

最要命的是未捕获异常或流错误导致进程崩溃。缺少 uncaughtException 和 unhandledRejection 的监听，连流错误事件都没处理，一旦出问题就是服务直接挂掉。全局异常兜底和流错误监听一定要加上。

二 根因与解决方案对照表

三 配置与落地实践

目录与权限：建议日志目录放在 /var/log/myapp。创建并授权的命令如下：

sudo mkdir -p /var/log/myapp
sudo chown -R nodeuser:nodegroup /var/log/myapp
sudo chmod -R 755 /var/log/myapp

记得用专用用户运行应用：sudo -u nodeuser node app.js。

日志轮转 logrotate：先安装 sudo apt-get install logrotate，然后在 /etc/logrotate.d/myapp 配置：

/var/log/myapp/*.log {
    daily
    missingok
    rotate 7
    compress
    notifempty
    create 0640 nodeuser nodegroup
}

统一结构化日志（Winston 示例）：分离错误与全量日志，统一 timestamp + level + message：

const winston = require('winston');
const logger = winston.createLogger({
    level: 'info',
    format: winston.format.combine(
        winston.format.timestamp(),
        winston.format.printf(({ timestamp, level, message }) => `${timestamp} ${level}: ${message}`)
    ),
    transports: [
        new winston.transports.File({ filename: 'error.log', level: 'error' }),
        new winston.transports.File({ filename: 'combined.log' })
    ]
});

运行方式与日志路径：环境变量是最灵活的方式。在启动脚本或 systemd 中设置 LOG_PATH，应用内读取后传给日志库。systemd 服务示例：

[Service]
ExecStart=/usr/bin/node /path/to/app.js
Environment=LOG_PATH=/var/log/myapp.log
User=nodeuser
Group=nodegroup
Restart=always

别忘了执行 sudo systemctl daemon-reload && sudo systemctl start myapp 让配置生效。简单场景下，也可以用命令行重定向：node app.js > logs/app.log 2>&1。

四 高效排查命令清单

• 实时查看应用日志：tail -f /var/log/myapp/combined.log
• 查看系统级日志：tail -f /var/log/syslog；内核/驱动相关：dmesg
• 定位占用端口/进程：ss -ltnp | grep :端口；lsof -iTCP:端口 -sTCP:LISTEN
• 检查文件占用：lsof /var/log/myapp/combined.log
• 监控日志目录变更：inotifywait -m /var/log/myapp -e create,delete,move
• 查看服务日志（systemd）：journalctl -u myapp.service -f

五 稳定性与性能建议

几个关键点需要记住：

• 生产环境千万别用 console.log，选 Winston、Pino、Bunyan 这类有级别、传输、格式化能力的库。
• 统一日志格式，优先用 JSON，包含 timestamp、level、service、pid、hostname 等字段，后面接入 ELK 或 Grafana Loki 时会省很多事。
• 文件日志一定要配轮转和压缩，否则磁盘被撑满是迟早的事。
• 异步流和文件写入要加上错误监听，防止异常传播导致进程崩溃。
• 高并发场景下，控制打点频率和采样率，减少不必要的字符串拼接和同步 I/O。