Node.js日志在Debian中的错误追踪

在Debian上跑Node.js，遇到报错是家常便饭。但真正让人头疼的是，错误到底藏在哪？系统日志、应用日志还是代码本身？别急，这篇指南就是帮你系统性地把错误揪出来，从底层系统到代码细节，一条龙捋清楚。

一、查看系统级日志

Debian的系统日志会记录Node.js进程的底层异常，比如启动失败、权限不足这类“硬伤”。常用的命令有两个：

• 实时追踪系统日志：tail -f /var/log/syslog（或者用journalctl，如果你用的是systemd）。配合grep node过滤，能快速锁定错误发生的时间和类型。
• 内核日志也别忘了：dmesg | grep node，专门用来诊断和硬件、内核模块有关的问题，比如端口冲突、内存溢出这些。

二、检查应用自身日志

Node.js应用自己的日志才是“主战场”，得通过内置方式或第三方库把错误老老实实记下来。

• 内置console模块：简单场景下直接用console.error()输出到控制台，开发调试足够了，但生产环境最好别指望它——太糙了。
• 第三方日志库（推荐）：
  • Winston：配置一个专门记录error级别的日志文件。示例：

    const winston = require('winston');
    const logger = winston.createLogger({
      level: 'error',
      format: winston.format.combine(
        winston.format.timestamp(),
        winston.format.json()
      ),
      transports: [
        new winston.transports.File({ filename: '/var/log/nodejs/error.log' })
      ]
    });
    // 用 logger.error('Error message:', error) 记录错误
    

  • PM2集成：如果用了PM2来管理应用，它自带的日志系统会自动捕获错误。运行pm2 logs可实时查看日志，也可以在ecosystem.config.js里指定错误日志路径：

    module.exports = {
      apps: [{
        name: 'my-app',
        script: 'app.js',
        error_file: '/var/log/nodejs/my-app-error.log'
      }]
    };
    

三、使用调试工具定位问题

日志只能告诉你“发生了什么”，想知道“为什么发生”，还得靠调试工具。两种主流方案：

• Node.js内置调试器：启动时加上--inspect-brk标志，比如node --inspect-brk app.js。然后打开Chrome浏览器，输入chrome://inspect，点击“为Node打开专用DevTools”，就能设置断点逐步调试了。
• VS Code调试：在项目里创建.vscode/launch.json文件，配置调试任务：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "launch",
        "name": "Debug Node.js",
        "program": "${workspaceFolder}/app.js",
        "skipFiles": ["/**"]
      }
    ]
  }
  

  通过VS Code的调试面板设断点，交互式排查，效率很高。

四、常见错误及解决方法

有些坑几乎是必遇到的，提前知道怎么处理能省不少时间：

• 端口冲突：用netstat -an | grep 端口号检查端口被谁占了，要么改端口，要么干掉占用进程。
• 权限问题：Node.js进程要对日志文件、项目目录有读写权限。用chown -R nodejs:user /var/log/nodejs调整所有权，别一股脑给777。
• 依赖包问题：先跑npm install补全缺失依赖，再用npm outdated检查过时包并更新。
• 脚本错误：通过console.error或日志库记录的堆栈信息，定位语法错误或逻辑bug——大多数时候堆栈会直接告诉你哪一行出了问题。

五、日志管理与轮转

日志文件不控制大小，早晚会把磁盘塞爆。Debian上推荐用logrotate：

• 安装：sudo apt-get install logrotate
• 创建配置文件/etc/logrotate.d/nodejs：

  /var/log/nodejs/*.log {
      daily
      rotate 7
      compress
      missingok
      notifempty
      create 0644 root root
  }
  

  • 测试配置：logrotate -d /etc/logrotate.d/nodejs（模拟运行）
  • 强制执行：logrotate -f /etc/logrotate.d/nodejs

把上面这几个步骤串起来，从系统日志到应用日志，再到调试器和错误处理，基本上能把Debian上Node.js的错误追查清楚，剩下的就是按图索骥解决问题了。