debian nodejs报错怎么查

在 Debian 上排查 Node.js 报错，一般可以按下面几个方向来查。

一、先看报错本身

1. 直接运行看完整报错

node yourfile.js

或

npm start

把完整报错信息（尤其是第一行 Error: ... 和堆栈）保存下来。

2. 常见报错类型

• Cannot find module → 模块没装
• EACCES / permission denied → 权限问题
• command not found: node → Node 没装或路径不对
• SyntaxError → 代码或 Node 版本不兼容

二、确认 Node / npm 环境

node -v
npm -v
which node

如果是 Debian 自带旧版本 Node，建议用 NodeSource 或 nvm 安装新版。

查看是否多个 Node：

ls /usr/bin/node*
ls /usr/local/bin/node

三、权限问题（非常常见）

不要直接用 sudo npm -g（容易权限乱）。

推荐：

sudo chown -R $USER:$USER ~/.npm

或用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

四、依赖问题

1. 清缓存重装

rm -rf node_modules package-lock.json
npm cache clean --force
npm install

2. 查看安装报错

npm install --verbose

3. Debian 常见缺失依赖

sudo apt update
sudo apt install -y build-essential python3 make g++

（一些 npm 包需要编译）

五、系统日志（服务类报错）

如果是 systemd 服务：

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

实时看：

journalctl -u your-node-service -f

六、端口 / 网络问题

sudo netstat -tulnp | grep node
# 或
sudo ss -tulnp

常见：

• EADDRINUSE → 端口被占用
• ECONNREFUSED → 服务没起或地址错

七、调试方式

node --trace-warnings yourfile.js
node --inspect yourfile.js

或用：

npm ERR! 报错时看上面 npm ERR! 行

八、你可以这样给我信息（我帮你精确定位）

把下面内容贴出来：

1. 完整报错（复制终端）
2. node -v / npm -v
3. Debian 版本（cat /etc/os-release）
4. 怎么运行的（直接 node / npm / systemd）

我可以直接帮你判断是 环境、权限、依赖还是代码问题。