GitHub Actions手动工作流动态选择SSH密钥加载失败问题

常见问题及修复方案 #

1. SSH私钥在Secret中格式损坏 #

这是最常见的触发原因。GitHub Secrets保存多行文本时，若直接粘贴私钥，可能会自动将换行符替换为空格，导致私钥结构失效，ssh-add无法识别。

验证方式：临时添加调试步骤查看私钥内容（调试后请立即删除，避免敏感信息泄露）：

- name: 检查私钥格式
  run: echo "${{ secrets[github.event.inputs.ssh_private_key_secret] }}" | head -20

如果输出是一整行无换行的文本，说明格式已损坏。

修复方法：

• 重新编辑对应GitHub Secret，完整复制私钥内容，确保包含开头的-----BEGIN OPENSSH PRIVATE KEY-----和结尾的-----END OPENSSH PRIVATE KEY-----，且每一行的换行都保留。
• 若问题仍存在，可将私钥转为base64编码后存入Secret，再在工作流中解码使用：

  - name: 解码SSH私钥
    run: echo "${{ secrets[github.event.inputs.ssh_private_key_secret] }}" | base64 -d > /tmp/ssh_key
  - name: 配置SSH代理
    uses: webfactory/ssh-agent@v0.8.0
    with:
      ssh-private-key: ${{ cat /tmp/ssh_key }}
  

2. 传入的Secret名称错误或不存在 #

若输入的ssh_private_key_secret对应的Secret不存在，secrets[]会返回空字符串，ssh-add加载空内容时就会抛出libcrypto错误。

修复方法：

• 核对GitHub仓库的Secrets列表，确保输入的Secret名称完全匹配（大小写敏感）。
• 添加验证步骤提前拦截错误：

  - name: 验证Secret存在性
    run: |
      if [ -z "${{ secrets[github.event.inputs.ssh_private_key_secret] }}" ]; then
        echo "错误：Secret ${{ github.event.inputs.ssh_private_key_secret }} 不存在"
        exit 1
      fi
  

3. SSH私钥已加密 #

如果私钥生成时设置了密码（加密状态），webfactory/ssh-agent默认无法自动输入密码，导致加载失败。

修复方法：

• 使用无密码的SSH私钥（生成命令：ssh-keygen -t ed25519 -N ""）。
• 若必须使用加密私钥，需额外配置密码Secret并传入，但不推荐此方案，会增加密钥泄露风险。

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