debian nodejs为什么报错

“Debian 上 Node.js 报错”这个现象太宽泛了，需要先看具体的报错内容。不过下面我给你总结 Debian 上 Node.js 最常见报错原因 + 对应解决办法，你可以对号入座。

一、最常见报错 1：node: command not found

原因

• 没装 Node.js
• 或装的是 nodejs 但命令名不对（老版本 Debian）

解决

which node
which nodejs

如果都没有：

sudo apt update
sudo apt install nodejs npm

Debian 旧版可能只有 nodejs 命令：

nodejs -v

二、报错 2：npm: command not found

原因

• 只装了 nodejs，没装 npm

解决

sudo apt install npm

三、报错 3：EACCES: permission denied

原因

• 用 npm install -g 没权限
• 或用了 root 装了全局包，普通用户用不了

解决（推荐）

不要用 sudo npm

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

四、报错 4：Node 版本太低

例如：

SyntaxError: Unexpected token ...

原因

Debian 官方源 Node 很旧（如 v10 / v12）

解决（用 NodeSource）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt install -y nodejs

五、报错 5：Cannot find module 'xxx'

原因

• 没执行 npm install
• 或项目路径不对

解决

cd 项目目录
npm install

六、报错 6：systemd / pm2 启动失败

例如：

Error: listen EADDRINUSE

原因

• 端口被占用
• 或重复启动

解决

sudo lsof -i:3000

七、报错 7：Debian + Nginx + Node 502

原因

• Node 没监听端口
• 或 proxy_pass 写错

检查

curl http://localhost:3000

八、你可以这样发给我，我能精准帮你

请把 完整报错信息 贴出来，例如：

• 命令：node app.js
• 报错：

Error: Cannot find module 'express'
    at ...

• Debian 版本：

cat /etc/os-release
node -v
npm -v

✅ 总结一句话：
Debian 上 Node.js 报错，90% 是 版本太旧 / 权限问题 / 没装依赖。

如果你愿意，把具体错误复制出来，我可以直接告诉你改哪一行。