远程SSH执行Flutter构建脚本时iOS签名失败求助

阿华AIGC实验室

2026-4-3

我之前折腾跨平台远程构建的时候，也碰到过一模一样的SSH跑iOS签名失败的问题！本地Mac直接跑脚本顺得不行，一通过Windows SSH过去就卡签名，给你几个实际踩坑后总结的解决方向：

先搞定钥匙串的解锁问题
你虽然手动允许了脚本访问钥匙串，但SSH会话是「无头」的（没有GUI交互），默认钥匙串是锁着的，脚本根本拿不到签名证书。可以在run_flutter.sh开头加上解锁命令：
```
# 建议用环境变量或交互式输入密码，不要硬编码到脚本里
security unlock-keychain -p "$KEYCHAIN_PASSWORD" ~/Library/Keychains/login.keychain-db
# 可选：设置钥匙串在SSH会话里保持解锁状态
security set-keychain-settings -u ~/Library/Keychains/login.keychain-db
```
要是不想明文写密码，也可以在SSH登录后先手动解锁钥匙串，再跑脚本。

同步本地用户的环境变量
本地Mac跑脚本时，GUI环境会加载~/.zshrc/~/.bash_profile里的Xcode、Flutter相关环境变量，但SSH会话默认不会加载全。在脚本开头加上这两行：

# 加载用户的shell配置，根据你用的shell选对应的文件
source ~/.zshrc  # bash用户换成~/.bash_profile
# 显式指定Xcode开发目录，避免SSH会话找不到
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"

确认签名身份在SSH会话里可访问
在脚本里先执行这个命令，看看能列出有效的代码签名证书不：
```
security find-identity -p codesigning -v
```
如果输出是空的或者没列出你要用的证书，说明钥匙串解锁后还是没加载到证书，这时候要确保SSH登录的用户和你本地跑脚本的是同一个用户（比如都是me），因为证书是绑定用户钥匙串的，跨用户访问不了。
加详细日志定位具体错误
把Flutter构建命令改成带-v的 verbose 模式：
```
flutter build ios -v
```
跑的时候盯着签名阶段的日志，会明确告诉你是「找不到证书」「钥匙串访问被拒」还是「权限不足」，根据具体错误再针对性解决比瞎试效率高多了。