安装Rails时提示rubygems源超时找不到有效gem包如何解决?
"ERROR: Could not find a valid gem 'rails' (>= 0), here is why:
Unable to download data from https://rubygems.org - timed out (https://api.rubygems.org/specs.4.8.gz)"
该报错是官方RubyGems源访问链路超时导致,属于网络连通性问题,可按以下步骤修复:
- 替换为国内稳定的RubyGems镜像源
依次执行以下命令:- 移除原有官方源:
gem sources --remove https://rubygems.org/gem sources --remove http://rubygems.org/ - 添加国内镜像源:
gem sources --add https://gems.ruby-china.com/ - 验证源配置,确保输出只有刚添加的国内源:
gem sources -l - 重新执行Rails安装命令:
gem install rails
- 移除原有官方源:
- 上述操作后仍报错的话,按以下方向排查:
- 检查本地是否开启了代理/VPN,可先关闭后重试,或配置gem走代理:
gem install rails --http-proxy http://<代理地址>:<端口> - 切换本地DNS为公共DNS(如114.114.114.114、8.8.8.8),清除DNS缓存后重试
- macOS用户需先安装Xcode命令行工具,执行
xcode-select --install完成安装后重试 - 确认当前Ruby版本适配待安装的Rails版本,最新版Rails要求Ruby版本≥2.7,可通过
ruby -v查看当前版本,版本过低可先升级Ruby后再安装
- 检查本地是否开启了代理/VPN,可先关闭后重试,或配置gem走代理:
- Bundler全局源同步替换(后续项目使用bundle安装依赖时可避免同类问题):
bundle config mirror.https://rubygems.org https://gems.ruby-china.com
内容的提问来源于stack exchange,提问作者lurkingPandora
相关产品推荐
相关产品推荐

