debian为何nodejs运行报错

在 Debian 上运行 Node.js 报错，常见原因有很多，下面按最常见 → 较少见给你系统梳理一下，你可以对照排查。

一、Node.js 根本没装 / 装错方式

现象

node: command not found

原因

• 没安装
• 只装了 nodejs 但命令是 nodejs 不是 node
• 用 apt 装了老版本（Debian 默认源很旧）

解决

推荐方式（官方源）

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

验证：

node -v
npm -v

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

现象

EACCES: permission denied

原因

• 用 root 装了全局包
• 普通用户运行没权限

解决

不要随便用 sudo npm

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

或：

sudo chown -R $USER:$USER /usr/lib/node_modules

三、Node 版本太低（Debian 老系统常见）

现象

SyntaxError: Unexpected token ...

原因

• Debian 10/11 自带 Node 10/12
• 新项目需要 Node 18+

解决

升级 Node（见第一节）

四、缺少依赖库

现象

error while loading shared libraries

原因

• 某些原生模块（bcrypt、sharp）缺系统库

解决

apt install -y build-essential libssl-dev

五、systemd / 服务运行报错

现象

Cannot find module

原因

• 用 root 跑，但装在用户目录
• 工作目录不对

解决

确保：

WorkingDirectory=/path/to/app
Environment=NODE_ENV=production

六、你贴具体报错我可以直接定位

如果你愿意，把完整报错信息贴出来（哪怕几行），我可以：

• 直接告诉你哪一步错了
• 给你一条命令解决

你可以直接发：

报错内容 + node -v + debian 版本