如何在GitHub Actions的if条件中判断secret变量是否为空

报错原因 #

Unrecognized named-value: 'secrets'报错通常有两个诱因：

1. 旧版GitHub Actions对job级if直接引用secrets的语法兼容不佳
2. 工作流由Fork仓库的PR触发时，默认没有secrets访问权限，系统会判定secrets为未定义值

你之前尝试的第二种写法if: ${{ secrets.AWS_ACCESS_KEY_ID }} != ''本身存在语法错误：GitHub Actions会先解析${{ }}内的内容替换成对应值，剩余的!= ''不属于表达式逻辑，会被识别为无效语法，所有判断逻辑都要放在${{ }}内部。

可行实现方案 #

方案1：job级直接判断（适用于非外部PR触发的场景） #

用in语法判断secret键是否存在，比直接判空逻辑更准确，可避免secret值为空字符串时的误判：

publish:
    runs-on: ubuntu-latest
    if: ${{ 'AWS_ACCESS_KEY_ID' in secrets && secrets.AWS_ACCESS_KEY_ID != '' }}
    steps:
      [ ... ]

方案2：step前置判断（全场景兼容，无语法报错） #

如果工作流需要支持外部PR触发，或者想完全规避语法报错，用前置step做判断是最稳妥的方式：

publish:
    runs-on: ubuntu-latest
    steps:
      - name: 检测AWS_ACCESS_KEY_ID是否配置
        id: secret_check
        run: |
          if [ -z "${{ secrets.AWS_ACCESS_KEY_ID }}" ]; then
            echo "secret_not_exist=1" >> $GITHUB_OUTPUT
          fi
      - name: 执行发布逻辑
        if: steps.secret_check.outputs.secret_not_exist != '1'
        run: |
          # 原有任务逻辑写在此处即可
          echo "开始执行发布流程"

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