iOS Jenkins代理构建Swift程序时遇rubygems/util加载错误求助

DevOps 小满

2026-5-25

解决iOS Jenkins代理构建Swift程序时的rubygems/util加载错误

嘿，我之前帮不少人排查过Jenkins构建iOS项目的类似问题，你遇到的这个rubygems/util加载错误，大概率是Ruby环境或者gem依赖的配置出了问题，下面给你几个实用的解决方向：

检查Jenkins代理的Ruby环境
首先得确认Jenkins代理用的Ruby版本和项目依赖匹配。很多时候Jenkins默认用系统自带的Ruby，但项目可能依赖通过rbenv、rvm管理的特定版本Ruby。你可以在Jenkins构建脚本里先加两行命令：
```
ruby --version
gem env
```
看看输出的Ruby环境信息，确保rubygems正常安装且路径正确。如果版本不对，就配置Jenkins用正确的Ruby版本，比如在构建步骤里添加rbenv初始化命令：eval "$(rbenv init -)"，或者指定rvm的对应版本。
重新安装出问题的gem
报错里明确指向了unicode-display_width这个gem，你可以先尝试重新安装这个特定版本的gem，甚至清理旧版本后再装：
```
gem uninstall unicode-display_width -v 1.3.2
gem install unicode-display_width -v 1.3.2
```
如果还是不行，也可以试试更新这个gem到最新兼容版本，或者直接执行bundle install重新安装所有项目依赖的gem，确保所有依赖都能正确加载。
同步Gemfile和Gemfile.lock的版本
有时候本地的Gemfile.lock和Jenkins代理上的版本不一致，会导致安装的gem出现冲突。你可以把本地最新的Gemfile.lock提交到代码仓库，然后在Jenkins构建时先执行：
```
bundle clean --force
bundle install
```
这样能保证Jenkins上安装的gem版本和本地完全一致，避免依赖版本不匹配的问题。
检查Jenkins代理的权限设置
还有一种可能是Jenkins运行的用户没有权限访问rubygems的安装目录，导致无法加载rubygems/util模块。你可以先用gem which rubygems/util命令找到这个模块的路径，然后检查该目录的权限，确保Jenkins运行用户有读取权限。如果权限不够，要么修改目录权限，要么让Jenkins用拥有足够权限的用户运行。