Github Actions输出$GITHUB_OUTPUT遇格式无效错误求助

问题分析 #

你遇到的Invalid format 'br-shrill-unit-918412'错误，本质是输出到$GITHUB_OUTPUT的内容不符合Github Actions的格式要求，常见原因包括：

• jq返回了多行结果（比如匹配到多个符合条件的分支）
• 输出内容包含不可见字符（如换行、前置空格）
• YAML脚本的引号嵌套或变量替换逻辑错误

解决步骤 #

1. 先调试确认jq的实际输出 #

在步骤中添加调试语句，排查jq返回内容的具体情况：

- name: Get existing Neon branch for this PR
  id: get-existing-branch
  run: |
    # 捕获jq结果并打印调试信息
    branch_id=$(jq --raw-output '.branches[] | select(.name | startswith("PR #${{ inputs.pr-number }} ")).id' list-neon-branches-response.json)
    echo "DEBUG: branch_id content: '$branch_id'"
    # 输出到GITHUB_OUTPUT
    echo "branch_id=$branch_id" >> "$GITHUB_OUTPUT"

通过调试信息可以确认：结果是否存在多余换行、空格，或是返回了多个分支ID。

2. 确保jq仅返回单个有效结果 #

修改jq表达式，避免多匹配或无匹配时的异常输出：

jq --raw-output '.branches | map(select(.name | startswith("PR #${{ inputs.pr-number }} "))) | .[0].id // empty' list-neon-branches-response.json

• 逻辑说明：用map()过滤出符合条件的分支，. [0].id取第一个匹配结果，// empty确保无匹配时返回空字符串而非报错。

3. 使用Here-Doc格式输出到GITHUB_OUTPUT #

这种格式能兼容单行/多行内容，彻底避免echo解析导致的格式问题：

- name: Get existing Neon branch for this PR
  id: get-existing-branch
  run: |
    echo "branch_id<<EOF" >> "$GITHUB_OUTPUT"
    jq --raw-output '.branches | map(select(.name | startswith("PR #${{ inputs.pr-number }} "))) | .[0].id // empty' list-neon-branches-response.json >> "$GITHUB_OUTPUT"
    echo "EOF" >> "$GITHUB_OUTPUT"

4. 修正YAML脚本的引号嵌套问题 #

如果是变量替换时的引号冲突，调整jq表达式的引号写法，确保Github Actions变量正确替换：

jq --raw-output '.branches[] | select(.name | startswith("PR #'"${{ inputs.pr-number }}"' ")).id' list-neon-branches-response.json

这里用单引号拼接变量，避免bash解析引号时出现逻辑错误。

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