组织中仓库变量传入GitHub Action为空的问题排查

问题场景 #

我在仓库中配置了环境变量METRICS_PUBLIC_KEY，并在GitHub Action的Pull Request工作流中通过以下方式注入环境变量：

- name: CI Metrics
      # To be more stable you can use a tag e.g.
      # https://raw.githubusercontent.com/ci-metrics/script/v0.1.0/run.py
      run: |
        wget https://raw.githubusercontent.com/ci-metrics/script/master/run.py
        python3 ./run.py
      env:
        # Variables to interact with CI Metrics.
        PUBLIC_KEY: ${{ vars.METRICS_PUBLIC_KEY }}
        PRIVATE_KEY: ${{ secrets.METRICS_PRIVATE_KEY }}
        # Variables to upload
        HEAD: ${{ github.event.pull_request.head.sha }}
        DATA_FILE: "./metrics"
        # Variables to diff
        TOKEN: ${{ secrets.GITHUB_TOKEN }}
        BASE: ${{ github.event.pull_request.base.sha }}
        ISSUE: ${{ github.event.pull_request.number }}

脚本执行后打印环境变量，结果显示PUBLIC_KEY: ''和PRIVATE_KEY: ''（PUBLIC_KEY预期值为'6546b543a35b7d5af8c93a7b'），但DATA_FILE、TOKEN等其他变量均能正常取值。

排查方向与解决方法 #

• Fork仓库权限限制
  如果PR来自Fork仓库，原仓库的vars和secrets默认无法被Fork的工作流访问。解决方式：

  • 确认PR来源是否为Fork；
  • 若为Fork场景，可在原仓库的「Settings」→「Actions」→「General」→「Workflow permissions」中开启相关权限，或在Fork仓库中手动同步对应的变量/密钥。

• 变量名称拼写错误
  检查仓库中配置的变量名是否为METRICS_PUBLIC_KEY，工作流中vars.METRICS_PUBLIC_KEY的拼写完全一致（GitHub变量区分大小写），避免出现少字符、大小写错误等问题。

• 变量未正确配置

  1. 进入仓库「Settings」→「Secrets and variables」→「Actions」，分别在Variables和Secrets标签下确认METRICS_PUBLIC_KEY和METRICS_PRIVATE_KEY存在且值正确；
  2. 确认变量作用域为「Repository」，若配置为环境作用域，需在工作流的job中添加environment字段指定对应环境。

• 工作流权限不足
  对于Pull Request触发的工作流，若触发权限不足可能导致无法读取仓库变量。可在工作流的job中添加权限声明：

  permissions:
    contents: read
  

内容的提问来源于stack exchange，提问作者Jonathan Woollett-light