如何将仓库环境变量插入GitHub Actions的cron字符串中

问题场景 #

尝试通过仓库环境变量动态设置GitHub Actions的cron调度频率，编写的workflow.yml内容如下：

env:
  UPDATE_FREQ: 15
on:
  schedule:
    - cron: "0/${{ env.UPDATE_FREQ }} * * * *"

执行后触发错误：

invalid `cron` attribute `"0/${{ env.UPDATE_FREQ }} * * * *"`

问题原因 #

GitHub Actions的on.schedule属于工作流触发配置，会在工作流初始化阶段被解析，此时环境变量还未加载，因此无法在这里使用表达式引用环境变量。

正确实现方式 #

方案一：使用仓库变量替代环境变量 #

仓库变量在工作流触发阶段即可被解析，适合用于调度配置类的初始化参数：

1. 进入仓库的「Settings」→「Secrets and variables」→「Actions」页面
2. 添加名为UPDATE_FREQ的变量，值设为15
3. 修改workflow.yml：

on:
  schedule:
    - cron: "0/${{ vars.UPDATE_FREQ }} * * * *"

方案二：通过动态判断实现灵活调度 #

如果需要使用环境变量或更灵活的频率调整，可以先设置基础调度，再在运行时判断是否执行任务：

env:
  UPDATE_FREQ: 15
on:
  schedule:
    - cron: "0 * * * *" # 每小时触发一次基础调度
jobs:
  execute-task:
    runs-on: ubuntu-latest
    steps:
      - name: 判断是否满足执行条件
        id: check-exec
        run: |
          current_min=$(date +%M)
          if [ $((current_min % UPDATE_FREQ)) -eq 0 ]; then
            echo "execute=true" >> $GITHUB_OUTPUT
          else
            echo "execute=false" >> $GITHUB_OUTPUT
          fi
      - name: 执行目标任务
        if: steps.check-exec.outputs.execute == 'true'
        run: |
          # 此处编写你的任务逻辑
          echo "执行定时任务"

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