在 CentOS 上解决 Node.js 依赖的可行路径
一、先判断系统是否满足 Node 版本要求
- 运行以下命令查看系统 glibc 版本：
- ldd --version
- 或 getconf GNU_LIBC_VERSION
- 对照关系：
- glibc ≥ 2.28：可直接使用 Node.js 18+
- glibc 2.17（CentOS 7）：Node.js 18+ 会出现 GLIBC/GLIBCXX 不满足的错误，需采用兼容方案（如 Snap、NVM 旧版二进制、或官方非官方构建）
二、按场景给出解决方案
- 场景 A：CentOS 7 且 glibc 2.17，需要 Node 18+
- 方案 1（推荐）：使用 Snap
- 修复 EPEL（CentOS 7 已 EOL，需切到 vault）
- sudo yum install -y https://archives.fedoraproject.org/pub/archive/epel/7/x86_64/Packages/e/epel-release-7-14.noarch.rpm
- sudo sed -i ‘s/^mirrorlist/#mirrorlist/g’ /etc/yum.repos.d/epel.repo
- sudo sed -i ‘s|#baseurl=http://download.fedoraproject.org/pub/epel|baseurl=http://archives.fedoraproject.org/pub/archive/epel|g’ /etc/yum.repos.d/epel.repo
- sudo yum clean all && sudo yum makecache
- 安装并启用 Snapd
- sudo yum install -y snapd
- sudo systemctl enable --now snapd.socket
- sudo ln -s /var/lib/snapd/snap /snap
- 安装 Node.js 18
- sudo snap install node --channel=18/stable --classic
- 若命令未找到，刷新并修复 PATH
- sudo snap refresh
- echo ‘export PATH=$PATH:/snap/bin:/snap/node/current/bin’ >> ~/.bashrc && source ~/.bashrc
- 或 logout/login、或 sudo reboot
- 方案 2：使用 NVM 安装旧版 Node（如 16.x LTS）
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- source ~/.bashrc
- nvm install 16 && nvm use 16
- 方案 3：使用 Node.js 官方非官方构建 unofficial-builds
- 适用于 glibc 2.17 的预编译二进制，下载即用（注意校验与来源可信）
- 场景 B：CentOS 8/9 或 glibc ≥ 2.28
- 使用 NodeSource 仓库安装（示例为 18.x）
- curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
- sudo dnf/yum install -y nodejs
- 或使用 NVM 安装所需版本（便于多版本共存）
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- source ~/.bashrc
- nvm install 18 && nvm use 18
三、项目依赖管理常用做法
- 初始化与安装
- npm：npm init -y；npm i 包名 --save；npm i 包名 --save-dev
- yarn：npm i -g yarn；yarn init；yarn add 包名；yarn add -D 包名
- pnpm：npm i -g pnpm；pnpm add 包名；pnpm add -D 包名
- 版本锁定与一致性
- 使用 package-lock.json / yarn.lock / pnpm-lock.yaml 锁定依赖版本
- 建议固定大版本范围（如 ^18.20.0），避免跨大版本导致原生模块不兼容
- 全局与本地工具
- 全局工具（如 pm2、typescript）建议固定版本：npm i -g pm2@latest
- 本地开发依赖与构建依赖分离，避免污染生产
四、常见报错与排查要点
- 报错示例
- /lib64/libc.so.6: version `GLIBC_2.28’ not found
- /lib64/libstdc++.so.6: version `GLIBCXX_3.4.21’ not found
- 处理思路
- 这是 glibc/ libstdc++ 版本过低 的典型表现，说明当前 Node 二进制与系统不兼容
- 不要尝试直接升级 glibc（风险极高，可能影响系统稳定性）
- 采用上文的 Snap / NVM 旧版二进制 / unofficial-builds 等兼容方案
- 其他提示
- 避免使用 –skip-broken 强行跳过依赖，可能导致运行时崩溃
- 若使用 Snap 安装后仍提示 command not found，执行 sudo snap refresh 并修正 PATH（/snap/bin、/snap/node/current/bin）
五、长期建议
- CentOS 7 已于 2024 年 EOL，Node.js 18 已于 2025 年 4 月 EOL，建议尽快迁移至 AlmaLinux 8/9 或 RHEL 8/9，可直接通过 dnf/yum 安装并维护依赖，整体更省心
