GitHub Action中存储AWS CLI命令响应至变量遇空输出问题

问题分析 #

你遇到的情况是：用::set-output捕获aws s3api head-object的输出时，最终输出变量为空，但替换成简单echo命令却能正常工作。这通常是因为：

• 旧的::set-output命令对包含特殊字符（比如引号、JSON结构符号）的输出处理存在兼容问题
• 部分场景下aws-cli的输出隐含不可见字符，导致::set-output解析失败

解决方案 #

改用GitHub Actions官方推荐的新输出设置方式（通过$GITHUB_OUTPUT文件），这种方式能更可靠地处理各类输出内容：

方案1：直接写入$GITHUB_OUTPUT #

- name: Check if certificate exists
  id: check_certificate
  run: |
    RESPONSE=$(aws s3api head-object --bucket test-bucket-ssl --key fullchain.pem)
    echo "S3_RESPONSE=$RESPONSE" >> $GITHUB_OUTPUT
- name: Print vars
  run: echo "${{ steps.check_certificate.outputs.S3_RESPONSE }}"

方案2：处理含特殊字符的输出 #

如果aws-cli的输出包含双引号或转义符，建议用jq将输出转为安全格式，避免解析错误：

- name: Check if certificate exists
  id: check_certificate
  run: |
    RESPONSE=$(aws s3api head-object --bucket test-bucket-ssl --key fullchain.pem | jq -r '@sh')
    echo "S3_RESPONSE=$RESPONSE" >> $GITHUB_OUTPUT
- name: Print vars
  run: echo "${{ steps.check_certificate.outputs.S3_RESPONSE }}"

额外排查点 #

1. 验证aws命令输出：先单独打印aws命令的输出，确认内容存在：

   - name: Test aws output
     run: aws s3api head-object --bucket test-bucket-ssl --key fullchain.pem
   

2. 检查权限：确保GitHub Action使用的AWS凭证拥有s3:GetObject权限，否则head-object会返回错误（输出可能为空或转向stderr）
3. 处理命令失败场景：如果目标文件不存在，head-object会返回非零退出码导致步骤失败，可添加|| true强制步骤成功并捕获错误输出：

   - name: Check if certificate exists
     id: check_certificate
     run: |
       RESPONSE=$(aws s3api head-object --bucket test-bucket-ssl --key fullchain.pem 2>&1 || true)
       echo "S3_RESPONSE=$RESPONSE" >> $GITHUB_OUTPUT
   

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