Windows自托管Runner中GitHub Jobs变量传递失败求助

问题根源 #

Windows自托管Runner使用PowerShell时，设置Job Output的语法逻辑与Ubuntu的Bash环境存在差异，若直接沿用Bash的echo "::set-output..."写法，容易因PowerShell的输出解析规则导致变量无法正确传递。

解决方案步骤 #

1. 第一个Job：正确获取状态码并设置Output #

在执行Invoke-WebRequest的步骤中，使用PowerShell语法规范标记Output变量，同时避免冗余输出干扰：

jobs:
  check-website-availability:
    runs-on: self-hosted-windows
    # 定义当前Job的输出变量，供后续Job调用
    outputs:
      site_status_code: ${{ steps.fetch_status.outputs.status_code }}
    steps:
      - name: Fetch website status
        id: fetch_status
        shell: pwsh
        run: |
          # 使用UseBasicParsing避免IE依赖问题，ErrorAction Stop确保异常中断流程
          $response = Invoke-WebRequest -Uri "https://your-production-site.com" -UseBasicParsing -ErrorAction Stop
          # 用Write-Output输出标准的GitHub Actions set-output指令，注意变量替换语法
          Write-Output "::set-output name=status_code::$($response.StatusCode)"

2. 第二个Job：通过needs引用Output变量 #

第二个Job需声明依赖第一个Job，再通过needs.<job-name>.outputs.<variable-name>获取传递的状态码：

send-teams-notification:
    runs-on: self-hosted-windows
    # 声明依赖第一个Job，确保其执行完成后再运行
    needs: check-website-availability
    steps:
      - name: Send status to Teams
        shell: pwsh
        run: |
          $statusCode = "${{ needs.check-website-availability.outputs.site_status_code }}"
          Write-Host "Received site status code: $statusCode"
          
          # 此处添加Teams通知逻辑，示例：
          # $teamsWebhook = "https://your-teams-webhook-url"
          # $body = @{ text = "Production site status: $statusCode" } | ConvertTo-Json
          # Invoke-RestMethod -Uri $teamsWebhook -Method Post -Body $body -ContentType "application/json"

3. 常见坑点排查 #

• 屏蔽冗余输出：Invoke-WebRequest默认会输出响应内容，需确保只有::set-output的行被输出，可通过> $null屏蔽：

  $response = Invoke-WebRequest -Uri "https://your-site.com" -UseBasicParsing -ErrorAction Stop > $null
  

• 变量替换规范：PowerShell中在字符串里引用对象属性需用$()包裹，如$($response.StatusCode)，否则会直接输出$response.StatusCode字符串而非实际值。
• Output定义匹配：确保第一个Job的outputs字段中，变量值的steps.<id>.outputs.<name>与步骤的id、set-output的name完全对应。

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