SSH远程连接mac-mini使用fastlane构建iOS应用报错如何解决

核心问题说明 #

该问题是macOS远程SSH会话权限限制导致的构建失败，本地VNC登录属于GUI用户会话，默认持有钥匙串、Xcode服务等所需的全部权限，而SSH会话默认处于受限的后台上下文，仅设置钥匙串「始终允许」不足以覆盖全部权限要求。 #

可行解决步骤 #

• 第一步：在执行构建前手动解锁登录钥匙串
  SSH会话默认不会自动解锁用户登录钥匙串，需提前执行解锁命令：
  security unlock-keychain -p "你的用户登录密码" ~/Library/Keychains/login.keychain-db
  如果担心明文密码泄露，可通过环境变量传入密码，避免直接写在脚本中。
• 第二步：延长钥匙串解锁有效期，防止构建中途自动上锁
  执行以下命令设置1小时的解锁有效期，覆盖常规构建时长：
  security set-keychain-settings -t 3600 -l ~/Library/Keychains/login.keychain-db
• 第三步：给codesign工具单独开放签名证书访问权限
  打开「钥匙串访问」应用，找到你用于iOS构建的开发者证书，展开证书条目选中对应的私钥，右键选择「显示简介」→「访问控制」标签，将/usr/bin/codesign添加到允许访问的应用列表，也可以直接勾选「允许所有应用程序访问此项目」后保存设置。
• 第四步：给SSH服务开放全磁盘访问权限
  macOS的TCC权限限制默认会拦截SSH会话的文件访问请求，打开「系统设置」→「隐私与安全性」→「全磁盘访问」，勾选/usr/sbin/sshd后重启SSH服务生效。
• 第五步：指定用GUI用户会话上下文执行fastlane
  SSH会话默认属于后台非GUI上下文，部分Xcode构建依赖的服务需要GUI用户会话权限，执行fastlane时改用如下命令：
  launchctl asuser $(id -u) zsh -c "fastlane 你的构建lane名称"

验证方法 #

可以先在SSH会话中依次执行前两步的钥匙串解锁命令，再手动运行fastlane构建，优先验证是否为钥匙串权限问题导致的失败。 #

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