SSH远程执行xcodebuild archive报ARCHIVE FAILED问题咨询

这种本地执行正常但SSH远程失败的情况，大概率是环境上下文差异或者权限/密钥访问问题导致的，我来给你几个针对性的排查和解决步骤：

1. 确保SSH会话加载完整的用户环境 #

本地终端默认是login shell，会自动加载.zshrc/.bash_profile这类配置文件，但SSH远程登录可能用的是非login shell，导致Xcode相关的环境变量（比如PATH、DEVELOPER_DIR）没有正确加载。你可以：

• 在执行xcodebuild命令前，先手动加载用户配置文件：

  source ~/.zshrc  # 若使用bash则替换为source ~/.bash_profile
  cd /path/to/your/project
  xcodebuild archive ...  # 你的完整打包命令
  

• 或者直接指定用login shell执行命令：

  ssh -t <system_username>@192.168.1.100 zsh -l -c "cd /path/to/project && xcodebuild archive ..."
  

2. 检查Pods嵌入脚本的可执行权限 #

有时候SSH会话下，Pods生成的脚本可能丢失了可执行权限，导致执行失败。你可以先在远程会话中给对应脚本添加权限：

chmod +x Pods/Target\ Support\ Files/Pods-GitHubActions/Pods-GitHubActions-frameworks.sh

（注意替换成你项目中对应的Target脚本路径，一般在Pods/Target Support Files/目录下）

3. 明确指定Xcode命令行工具路径 #

SSH会话可能默认指向了旧版Xcode或者独立的命令行工具，导致xcodebuild执行异常。你可以先切换到正确的Xcode路径：

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

或者直接使用完整路径执行xcodebuild：

/Applications/Xcode.app/Contents/Developer/usr/bin/xcodebuild archive ...

4. 解锁钥匙串并确保代码签名权限 #

本地终端通常已经解锁了登录钥匙串，但SSH远程会话中钥匙串默认是锁定的，这会导致代码签名失败，进而触发Pods脚本执行错误：

• 先在SSH会话中解锁钥匙串：

  security unlock-keychain -p "你的钥匙串密码" ~/Library/Keychains/login.keychain-db
  

• 另外，检查钥匙串中代码签名私钥的访问权限：打开本地的「钥匙串访问」应用，找到对应的Code Sign Identity私钥，右键选择「显示简介」，在「访问控制」标签下，确保xcodebuild被添加到允许列表，或者临时勾选「允许所有应用访问此项目」（测试环境下可这么操作，生产环境建议按需添加）。

5. 获取详细错误日志定位问题 #

如果上面的步骤都没解决，你需要查看更详细的错误信息：

• 在xcodebuild命令中添加-verbose参数，输出完整执行日志：

  xcodebuild archive ... -verbose
  

• 或者查看Archive生成的日志文件：

  cat $PWD/build/GitHubActions.xcarchive/Logs/Archive.log
  

里面会记录Embed Pods Frameworks脚本执行失败的具体原因，比如找不到某个依赖工具、路径错误或者权限不足，根据具体信息再针对性解决。

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