温馨提示×

ubuntu nodejs报错怎么解

小樊
38
2026-09-25 03:23:45
栏目: 编程语言

“Ubuntu 下 Node.js 报错”范围很广,不同报错原因不同。你可以先把完整的报错信息贴出来,我才能精准帮你。

不过,下面先给你一份 Ubuntu 上 Node.js 常见报错 & 通用解决办法,你可以对照看看:


一、最常见报错速查

1️⃣ command not found: node / node: command not found

原因:Node.js 没装或没加入 PATH

✅ 解决:

node -v

如果没版本号:

sudo apt update
sudo apt install nodejs npm

推荐用 NodeSource(版本更新):

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

2️⃣ EACCES: permission denied / npm ERR! code EACCES

原因:用 sudo 装包或全局目录权限问题

✅ 解决(推荐):

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

❌ 不建议:

sudo npm install -g xxx

3️⃣ Cannot find module 'xxx'

原因:依赖没装

✅ 解决:

rm -rf node_modules package-lock.json
npm install

4️⃣ Port 3000 is already in use

原因:端口被占

✅ 解决:

lsof -i:3000
kill -9 <PID>

或改代码端口


5️⃣ openssl legacy provider 报错(Node 17+)

报错示例:

Error: error:0308010C:digital envelope routines::unsupported

✅ 解决:

export NODE_OPTIONS=--openssl-legacy-provider

或升级构建工具


6️⃣ GLIBC / version not found

原因:Node 版本太新,Ubuntu 太老

✅ 解决:

  • 用 nvm 装低版本 Node
nvm install 18
nvm use 18

二、建议你这样提供信息(方便精准解决)

请贴出:

  1. Ubuntu 版本
    lsb_release -a
    
  2. Node 版本
    node -v
    npm -v
    
  3. 完整报错信息(截图或文字)
  4. 做什么操作时报的错(npm install?node app.js?)

如果你愿意,直接把报错内容复制过来,我一步一步帮你修 ✅

0 踩