仅Jenkins执行时iOS构建失败，求排查方向

• 检查Jenkins与终端的环境变量差异
  Jenkins的执行环境和本地终端的环境变量往往存在差异，这是这类问题的常见原因：

  • 在Jenkins构建脚本开头添加env > jenkins_env.log，同时在终端执行env > terminal_env.log，对比两份日志，重点关注PATH、XCODE_SELECT、HOME、GEM_HOME等与Xcode、CocoaPods相关的变量。
  • 验证xcode-select -p在Jenkins和终端的输出是否一致，确保指向的是Xcode 15.1的安装路径。

• 确认Jenkins用户的权限配置
  Jenkins通常以独立用户身份运行，权限可能和终端登录用户不同：

  • 检查Jenkins用户对工作区、Derived Data、Pods文件夹的读写权限，可执行sudo -u [jenkins用户名] ls -la [目标路径]验证。
  • 前往Mac系统设置的「隐私与安全性」，确认已授予Jenkins相关权限（如文件系统访问、钥匙串访问），避免权限弹窗被系统拦截。

• 深挖[CP] Embed Pods Frameworks脚本的具体错误
  退出码65只是结果，需要定位脚本内的具体失败点：

  • 在Fastlane的gym命令中添加verbose: true参数，输出更详细的构建日志，找到[CP]脚本执行时的具体报错信息（如找不到framework、签名失败、权限不足等）。
  • 可在Xcode项目的「Build Phases」中编辑[CP] Embed Pods Frameworks脚本，开头添加set -x，强制输出每一步执行命令，精准定位出错行。

• 验证CocoaPods与Gem环境一致性
  确保Jenkins和终端使用的CocoaPods版本、Ruby环境一致：

  • 在Jenkins和终端分别执行pod --version，对比版本是否相同；若不同，需统一CocoaPods版本，或在Jenkins脚本中指定正确的pod路径。
  • 检查Ruby环境（如rbenv/rvm），确认Jenkins执行时加载的Gem环境与终端一致，避免因Gem依赖不同导致pod执行异常。

• 排查Xcode签名与钥匙串访问问题
  签名失败常触发Embed Pods Frameworks脚本报错：

  • 确认Jenkins执行归档时使用的签名证书、描述文件与终端一致，检查是否存在证书过期、描述文件失效情况。
  • 在Jenkins构建脚本中添加钥匙串解锁命令：security unlock-keychain -p [钥匙串密码] ~/Library/Keychains/login.keychain-db，确保Jenkins用户能访问签名证书。

• 检查系统资源与进程冲突
  系统资源不足或进程冲突可能导致构建中断：

  • 构建时监控系统CPU、内存、磁盘空间占用，确保无资源耗尽情况。
  • 检查是否有Xcode相关后台进程（如xcodebuild、xcpretty）残留，可在构建前执行killall xcodebuild清理进程。

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