GitLab CI/CD中Fastlane 2.226.0报FastlaneCore::UpdateChecker未初始化问题

问题背景 #

• 环境：Ruby 3.1.0（rbenv安装）、Fastlane 2.226.0、macOS arm64-darwin23
• 本地执行bundle exec fastlane beta可正常部署到TestFlight，但GitLab CI流水线中执行相同命令时触发错误：

  uninitialized constant FastlaneCore::UpdateChecker (NameError)
  

• 已尝试操作：rbenv版本验证、Bundler重装Fastlane、清理gem缓存、确认CI Ruby版本等

可能原因及对应解决办法 #

1. CI环境依赖版本与本地不一致 #

本地的Gemfile.lock记录了精确的依赖版本，但CI可能没有严格遵循，导致FastlaneCore版本不匹配（UpdateChecker属于FastlaneCore模块）。

解决步骤：

• 在CI流水线中强制使用项目的Gemfile.lock，执行依赖安装时添加--deployment参数，确保依赖完全匹配：

  bundle install --deployment
  

• 若CI使用缓存，务必将vendor/bundle目录纳入缓存范围，同时在流水线中添加缓存清理步骤（排查时用于重置依赖）：

  bundle clean --force
  bundle install --deployment
  

• 直接在Gemfile中锁定Fastlane及FastlaneCore的版本，避免版本漂移：

  gem "fastlane", "2.226.0"
  # 从本地Gemfile.lock中复制与Fastlane 2.226.0兼容的FastlaneCore版本号
  gem "fastlane_core", "0.179.0"
  

2. CI环境未正确加载rbenv配置 #

rbenv的环境变量通常在登录shell中加载，但GitLab CI默认可能使用非登录shell，导致实际使用的Ruby版本并非指定的3.1.0，进而依赖安装到错误环境。

解决步骤：

• 在CI脚本开头添加rbenv初始化命令，确保加载正确的Ruby环境：

  eval "$(rbenv init -)"
  rbenv local 3.1.0
  # 验证版本是否正确
  ruby -v
  bundle -v
  

• 确认CI的执行shell设置为登录shell（例如在GitLab CI配置中指定shell: /bin/bash -l）

3. CI环境存在全局Fastlane干扰 #

若CI服务器全局安装了Fastlane，可能会优先调用全局版本而非bundle安装的版本，导致依赖不匹配。

解决步骤：

• 避免在CI中全局安装Fastlane，完全依赖Bundler管理的版本
• 替换执行命令，直接调用bundle安装的Fastlane二进制文件：

  $(bundle show fastlane)/bin/fastlane beta
  

4. Fastlane版本兼容性问题 #

Fastlane 2.226.0可能与Ruby 3.1.0或macOS arm64环境存在兼容性问题，导致CI中加载模块失败。

解决步骤：

• 尝试升级或降级Fastlane版本，例如升级到2.227.0或降级到2.225.0，同时更新Gemfile和Gemfile.lock
• 若使用arm64架构，确保所有依赖都支持该架构，可在CI中添加架构验证：

  arch
  

附加配置检查 #

请确认.gitlab-ci.yml中部署阶段的脚本顺序正确，示例参考：

deploy:
  stage: deploy
  tags:
    - macos-arm64
  script:
    - eval "$(rbenv init -)"
    - rbenv local 3.1.0
    - ruby -v
    - bundle install --deployment
    - bundle exec fastlane beta
  only:
    - main

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