CentOS-7镜像安装Node12与Yarn1.22遇RangeError问题求助

我之前在CentOS 7的GenericCloud镜像上部署Node.js 12时也碰到过一模一样的报错，折腾了一阵才找到根源——这个RangeError: Index out of range其实是CentOS 7自带的老旧glibc（2.17版本）和Node.js 12预编译包不兼容导致的，Node.js 10能正常运行是因为它的预编译包对旧系统兼容性更好。

下面给你几个经过验证的解决方案，按推荐程度排序：

方案一：用NodeSource适配CentOS 7的源安装 #

NodeSource专门为不同Linux发行版做了适配的Node.js源，能完美兼容CentOS 7的环境，这是最省心的方法：

1. 先添加NodeSource的Node.js 12仓库：

   curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash -
   

2. 安装Node.js（会自动匹配系统的libc版本）：

   sudo yum install -y nodejs
   

3. 安装指定版本的Yarn 1.22：

   curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
   sudo yum install -y yarn-1.22.0-1
   

方案二：通过nvm从源码编译安装 #

如果不想用系统级的Node.js，nvm可以帮你从源码编译，完全适配当前系统环境，避免预编译包的兼容性问题：

1. 先安装编译Node.js需要的依赖工具：

   sudo yum groupinstall -y "Development Tools"
   sudo yum install -y openssl-devel libicu-devel
   

2. 安装nvm并配置环境：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   # 重新加载shell配置让nvm生效
   source ~/.bashrc
   

3. 安装并切换到Node.js 12：

   nvm install 12
   nvm use 12
   

4. 安装Yarn 1.22：

   npm install -g yarn@1.22.0
   

方案三：升级系统glibc（谨慎操作） #

这个方法有一定风险，因为glibc是系统核心库，升级不当可能导致系统崩溃，仅当上面两个方案都不行时再尝试：

1. 安装CentOS软件集合源（SCL）：

   sudo yum install -y centos-release-scl
   

2. 安装更高版本的glibc（比如2.28）：

   sudo yum install -y glibc228 glibc228-devel
   

3. 临时设置环境变量让Node.js使用新的glibc：

   LD_LIBRARY_PATH=/opt/rh/glibc228/root/lib64:$LD_LIBRARY_PATH node -v
   

   如果要永久生效，可以把这个环境变量添加到~/.bashrc或者/etc/profile文件中。

验证安装成功 #

安装完成后，运行以下命令确认版本是否正确：

node -v # 应该输出v12.x.x
yarn -v # 应该输出1.22.x

再运行一个简单的测试脚本验证功能正常：

console.log("Node.js 12 is running smoothly!");

如果能正常输出内容，就说明问题已经解决了。

内容的提问来源于stack exchange，提问作者Chaitali