怎样定位debian nodejs错误

在 Debian 上定位 Node.js 错误，可以按“现象 → 日志 → 运行环境 → 代码 → 系统层”的顺序逐步排查。下面是一套实用方法。

一、确认 Node.js 基本环境

先排除最基础的问题：

node -v
npm -v
which node

如果是通过 apt 安装的：

dpkg -l | grep nodejs

常见坑：

• 系统自带 node 是 v10/v12（太旧）
• 同时装了 nvm 和 apt 的 node，版本冲突

二、直接运行看错误输出

1. 前台运行

node app.js

重点看：

• 错误类型（TypeError / ReferenceError / Error）
• 堆栈信息（stack trace）
• 出错文件与行号

2. 使用 --stack-trace-limit

node --stack-trace-limit=100 app.js

三、查看系统日志（Debian 特有）

1. systemd 服务（常见）

如果你用 systemctl 启动 Node：

journalctl -u your-node-service -n 100 --no-pager

实时查看：

journalctl -u your-node-service -f

2. 传统日志

/var/log/syslog
/var/log/messages

四、捕获未处理异常

在代码里加：

process.on('uncaughtException', (err) => {
  console.error('Uncaught Exception:', err);
});

process.on('unhandledRejection', (reason) => {
  console.error('Unhandled Rejection:', reason);
});

五、调试模式

1. 内置调试

node --inspect app.js

然后用 Chrome：

chrome://inspect

2. 使用 ndb（推荐）

npx ndb app.js

六、权限 & 依赖问题（Debian 常见）

1. 权限错误

EACCES: permission denied

解决：

sudo chown -R $USER:$USER /path

不要随便用 sudo npm -g

2. 原生模块编译失败

node-gyp rebuild

需要：

sudo apt install build-essential python3

七、内存 / 资源问题

查看是否 OOM

dmesg | grep -i oom
journalctl | grep -i kill

增加内存限制

node --max-old-space-size=2048 app.js

八、生产环境建议

• 使用 pm2

pm2 logs
pm2 monit

• 使用 dotenv 管理配置
• 写错误日志到文件（winston / pino）

九、快速定位 checklist

✅ node 版本是否匹配
✅ 是否 systemd 启动
✅ journalctl 有无报错
✅ 是否权限问题
✅ 是否依赖未安装
✅ 是否内存不足

如果你愿意，可以把：

• 具体错误信息
• 启动方式（systemd / pm2 / 直接 node）
• Debian 版本

发出来，我可以直接帮你定位。