GitHub Workflow中setup-ruby自定义Gem安装的问题排查

问题核心 #

手动安装nokogiri成功，但ruby/setup-ruby@v1开启bundler-cache时编译失败，原因是setup-ruby会重建依赖环境，默认缺少xslt系统级依赖，且手动安装的gem不会被bundler-cache复用。

具体解决方案 #

1. 提前安装系统依赖 #

在ruby/setup-ruby步骤前，给Ubuntu runner（GitHub Actions默认环境）安装缺失的xslt库：

- name: 安装系统依赖
  run: sudo apt-get update && sudo apt-get install -y libxslt1-dev

2. 移除手动安装nokogiri的步骤 #

ruby/setup-ruby@v1的bundler-cache会自动处理gem安装，手动安装的gem会和缓存机制冲突，直接删掉sudo gem install nokogiri -v 1.16.4这一步。

3. 正确配置setup-ruby步骤 #

确保workflow中的setup-ruby配置符合项目需求，示例：

- name: 配置Ruby环境
  uses: ruby/setup-ruby@v1
  with:
    ruby-version: '3.2' # 替换为你的项目Ruby版本
    bundler-cache: true

4. （可选）强制nokogiri使用系统库 #

如果仍有问题，在bundle install前设置环境变量，强制nokogiri调用系统已安装的xslt库：

- name: 设置Nokogiri环境变量
  run: echo "NOKOGIRI_USE_SYSTEM_LIBRARIES=true" >> $GITHUB_ENV

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