GitHub Actions CI中Ruby v3.x下Bundler无法匹配本地Gem问题求助

1. 核对版本配置一致性 #

• 确认项目根目录Gemfile中引用本地gem的方式是否正确，比如是否使用gem 'blacklight_allmaps', path: '.'或gemspec指令
• 检查.gemspec文件里的spec.version是否严格为'0.2.0'，排查是否存在拼写错误、空格或引号格式问题

2. 清理缓存与残留文件 #

GitHub Actions的缓存可能留存旧依赖，在CI流程的bundle install前添加清理步骤：

bundle clean --force
rm -rf vendor/bundle
rm Gemfile.lock

本地测试时也可执行上述命令，重新执行bundle install排除缓存干扰

3. 调整Bundler安装参数 #

Ruby 3.3对gem加载逻辑有细微调整，尝试在CI的bundle install命令中显式指定路径：

bundle install --local
# 或指定安装目录
bundle install --path vendor/bundle

同时检查CI环境中是否存在BUNDLE_GEMFILE环境变量被意外覆盖的情况

4. 检查CI工作流步骤顺序 #

• 确认CI workflow中，bundle install前是否有修改gem环境的步骤（比如安装全局gem、切换Ruby版本后未重新初始化Bundler）
• 添加bundle config list命令到CI流程，查看当前Bundler配置，确认本地gem路径是否被正确识别

5. 本地复现并验证 #

在本地用rbenv或rvm搭建Ruby 3.3环境，执行以下操作：

1. 克隆项目代码并切换至对应分支
2. 执行bundle install观察是否复现错误
3. 若本地复现，手动构建并安装gem：gem build blacklight_allmaps.gemspec && gem install ./blacklight_allmaps-0.2.0.gem，再执行bundle install测试是否解决问题

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