GitHub Action中从Secret读取的环境变量为空问题排查

DevOps 小满

2026-6-20

问题：GitHub Pages工作流中INSTAGRAM_ACCESS_TOKEN环境变量为空

我有一个托管标准Jekyll网站的GitHub Pages仓库，尝试添加以下工作流更新内容：

name: Update gallery
on: push

jobs:
  update_gallery:
    runs-on: ubuntu-latest

    steps:
      - name: Update gallery
        env:
          INSTAGRAM_ACCESS_TOKEN: ${{ secrets.INSTAGRAM_ACCESS_TOKEN }}
        run: |
          echo 'ENV GREP'
          env | grep INSTAGRAM
          echo 'WC -M'
          echo $INSTAGRAM_ACCESS_TOKEN | wc -m

但运行后发现INSTAGRAM_ACCESS_TOKEN环境变量为空，作业输出如下：

ENV GREP
INSTAGRAM_ACCESS_TOKEN=
WC -M
0

我最初在github-pages环境中设置了该Secret，之后又尝试使用自定义环境，但均无效果。请问该环境变量为空的原因是什么？

可能的原因及解决方法

工作流未关联目标环境：若你是在特定环境（比如github-pages或自定义环境）下设置的Secret，必须在工作流的jobs节点下明确指定environment字段，否则Secret不会被注入到作业中。修改后的工作流示例：
```
jobs:
  update_gallery:
    runs-on: ubuntu-latest
    environment: github-pages # 替换为你设置Secret的环境名称
    steps:
      # 后续步骤不变
```
Secret名称拼写不一致：GitHub的Secret名称是大小写敏感的，检查仓库中设置的Secret名称是否和INSTAGRAM_ACCESS_TOKEN完全一致，包括大小写、下划线等符号。
Secret未添加到当前仓库：确认你是将Secret添加到了托管Jekyll网站的这个GitHub Pages仓库中，而非其他仓库或组织级Secret（若使用组织级Secret，需确保当前仓库被授权访问该Secret）。
环境分支权限限制：如果你的环境设置了分支保护规则，仅允许特定分支触发该环境的Secret，而你推送代码的分支不在允许列表内，Secret也会为空。可前往仓库「Settings」→「Environments」页面，查看对应环境的「Deployment branches」设置，确认推送分支符合要求。