如何在Fastlane中将构建号设为CI_PIPELINE_ID？构建号未生效排查

从你描述的现象来看，代码确实没进入if ENV['CI_PIPELINE_ID']分支，大概率是这个环境变量在Fastlane的执行上下文里不可用或者为空。下面是几个最可能的原因和对应的解决办法：

1. CI_PIPELINE_ID未被正确传递到Fastlane进程 #

很多CI系统（比如GitLab CI）会预定义CI_PIPELINE_ID变量，但如果你的Runner环境是隔离的（比如Docker容器），或者CI配置里没有把变量暴露给执行Fastlane的任务，Fastlane就拿不到这个值。

验证方式：在CI配置中，运行Fastlane命令前先添加一行调试输出：

echo "CI_PIPELINE_ID value in CI shell: $CI_PIPELINE_ID"

如果输出为空，说明CI那边没把变量传进来。

修复方案：

• 如果是GitLab CI，确保你的Runner没有禁用预定义变量（默认是开启的）；
• 如果是自定义脚本启动Fastlane，手动把变量传递进去：

  fastlane build your_target CI_PIPELINE_ID=$CI_PIPELINE_ID
  

2. Fastlane中环境变量的判断逻辑有漏洞 #

Ruby中，空字符串""在if判断里会被视为false，所以如果CI_PIPELINE_ID存在但值为空，代码也不会进入分支。

修复方案：修改判断条件，确保变量存在且非空，同时添加调试输出确认取值：

def build(target_name)
  cocoapods
  cert
  sigh
  # 调试输出：确认Fastlane能拿到的变量值
  puts "Fastlane detected CI_PIPELINE_ID: #{ENV['CI_PIPELINE_ID']}"
  # 更严谨的非空判断
  if ENV['CI_PIPELINE_ID'].present? # Fastlane已内置ActiveSupport，可直接用
    increment_build_number(build_number: "#{ENV['CI_PIPELINE_ID']}")
    # 验证修改是否生效
    puts "Successfully updated build number to: #{get_build_number}"
  end
  build_app(
    scheme: target_name,
    workspace: WORKSPACE_FILE_PATH,
    clean: true,
    output_directory: OUTPUT_PATH,
    output_name: target_name + '.ipa',
    export_options: {
      provisioningProfiles: {
        BETA_BUNDLE_IDENTIFIER => BETA_PROVISIONING_PROFILE,
        DEMO_BUNDLE_IDENTIFIER => DEMO_PROVISIONING_PROFILE,
        DEV_BUNDLE_IDENTIFIER => DEV_PROVISIONING_PROFILE
      }
    }
  )
end

3. increment_build_number的修改被后续操作覆盖 #

虽然你设置了clean: true，但有时候如果Xcode缓存没有完全清理，或者build_app的某些配置读取了旧的构建号，可能导致最终IPA里的版本号没更新。

验证方式：查看CI日志中get_build_number的输出，如果显示已经修改成流水线ID，但IPA里还是旧值，那需要检查Xcode项目配置：确保构建号是从Info.plist或者xcodeproj的设置中读取的，没有被硬编码。

4. Fastlane执行上下文的权限问题 #

极少数情况下，Fastlane没有权限修改Xcode项目的构建号（比如CI Runner的用户没有项目目录的写入权限），导致increment_build_number执行失败但没有报错。

验证方式：查看CI日志中increment_build_number的执行输出，看是否有报错信息。如果有，调整项目目录的权限，确保Runner用户可以修改文件。

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