Debian为何Nodejs启动失败

Debian 上 Node.js 启动失败 的原因有很多，常见原因和排查方法如下（按出现频率排序）：

一、最常见原因

1️⃣ Node.js 未安装或路径错误

现象

node: command not found

排查

which node
node -v

解决

sudo apt update
sudo apt install -y nodejs npm

✅ 推荐安装新版本（Debian 自带版本较旧）：

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

2️⃣ Node.js 版本过低（Debian 稳定版常见问题）

现象

SyntaxError: Unexpected token ...

原因

Debian 10/11 仓库中 Node.js 可能是 v10 / v12

解决

node -v
# 如果是 v10 或更低，建议升级

使用 nvm 安装新版（推荐）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

3️⃣ 端口被占用（最常见于 Web 服务）

现象

Error: listen EADDRINUSE: address already in use :::3000

排查

sudo lsof -i :3000

解决

kill -9 PID

或换端口：

app.listen(3001);

4️⃣ 权限不足（systemd / root 问题）

现象

EACCES: permission denied

排查

whoami
ls -l yourfile.js

解决

不要 sudo node（除非真的需要）
给普通用户权限：

sudo chown -R $USER:$USER /your/project

5️⃣ systemd 启动失败（生产环境最常见）

现象

sudo systemctl status mynode

常见错误

ExecStart 路径错误
Node 不在 systemd 的 PATH 中

正确示例

[Service]
ExecStart=/usr/bin/node /var/www/app/index.js
Restart=always
User=nodeuser

✅ 用绝对路径，不要用 node 直接写

6️⃣ 依赖未安装

现象

Error: Cannot find module 'express'

解决

rm -rf node_modules package-lock.json
npm install

7️⃣ 架构 / glibc 不兼容（ARM / 老 Debian）

现象

cannot execute binary file

排查

uname -m
node -v

✅ 使用对应架构的 Node.js

二、快速自检清单 ✅

node -v
npm -v
which node
df -h        # 磁盘满？
free -h      # 内存不足？
journalctl -xe

三、如果你愿意，我可以精确帮你定位

请直接贴出 完整报错信息，例如：

systemctl status xxx
node app.js 的输出
Debian 版本（cat /etc/os-release）

我可以 1 分钟帮你判断是 版本 / 端口 / 权限 / systemd / 依赖 哪一类问题。