GitHub Actions重跑定时任务如何保留原始计划运行日期

GitHub Actions 没有内置等价于 Airflow execution_date、BigQuery @run_time 的原生变量，重跑任务时所有默认时间类上下文（包括github.run_started_at、SQL里取的CURRENT_DATE）都会默认取重跑当下的时间，不会自动保留cron首次触发时的计划运行参数，可通过以下成熟方案实现需求：

方案1：工作流构件持久化原始参数（最通用，适配自动重跑场景） #

核心逻辑是首次cron触发时就把需要保留的运行参数（比如原始业务日期）存为和当前工作流运行绑定的构件，后续重跑时直接读取构件里的参数，不再实时取当前日期。
实现步骤：

• 在工作流所有业务逻辑的最前面加参数初始化步骤，首次触发（cron触发、无历史参数构件）时，提取首次运行的计划日期写入本地文件；如果检测到当前run已经存在参数构件，直接读取构件里的历史参数
• 将参数文件上传为工作流构件，设置足够长的保留周期（比如90天，覆盖可能的重跑周期）
• 后续所有SQL执行步骤，统一使用读取到的原始日期作为入参，替换原逻辑里的CURRENT_DATE取值

参考实现代码：

name: Daily SQL Job
on:
  schedule:
    - cron: '0 0 * * *' # 每日0点触发
jobs:
  execute-sql:
    runs-on: ubuntu-latest
    steps:
      - name: 初始化运行参数
        id: init_params
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          # 尝试拉取当前run已存的参数构件
          if gh run download ${{ github.run_id }} -n run-params --dir ./saved_params 2>/dev/null; then
            echo "检测到历史运行参数，加载原始配置"
            ORIGINAL_DATE=$(cat ./saved_params/biz_date.txt)
          else
            echo "首次运行，写入当前触发时间作为业务日期"
            # 取cron触发的时间计算业务日期，可根据时区自行调整格式
            ORIGINAL_DATE=$(date -d "${{ github.run_started_at }}" +%Y-%m-%d)
            mkdir -p ./saved_params
            echo $ORIGINAL_DATE > ./saved_params/biz_date.txt
          fi
          # 将参数输出给后续步骤调用
          echo "biz_date=$ORIGINAL_DATE" >> $GITHUB_OUTPUT

      - name: 持久化参数到工作流构件
        if: ${{ !hashFiles('./saved_params/biz_date.txt') }}
        uses: actions/upload-artifact@v4
        with:
          name: run-params
          path: ./saved_params/
          retention-days: 90 # 保留90天，按需调整

      - name: 执行业务SQL
        run: |
          echo "当前执行SQL对应业务日期: ${{ steps.init_params.outputs.biz_date }}"
          # 此处调用SQL执行工具，将${{ steps.init_params.outputs.biz_date }}作为日期参数传入，替换原CURRENT_DATE逻辑

注意：从原工作流运行页面点击「重跑失败作业」「重跑所有作业」时，工作流Run ID保持不变，因此可以稳定拉取到首次运行上传的参数构件，不会出现参数丢失问题。

方案2：叠加手动触发参数，兼容补数场景 #

如果需要支持手动补跑历史日期的任务，可以给工作流加workflow_dispatch触发入口，增加日期输入项，和上述参数逻辑打通：

on:
  schedule:
    - cron: '0 0 * * *'
  workflow_dispatch:
    inputs:
      biz_date:
        description: '补数时指定业务日期，格式YYYY-MM-DD，留空则取当前日期'
        required: false
        type: string
        default: ''

在初始化参数步骤里加一层判断：如果是workflow_dispatch触发且传入了biz_date参数，优先使用传入的日期作为运行参数，适配手动补数需求。

避坑说明 #

• 不要依赖GitHub Actions内置的时间上下文（比如github.run_started_at、github.event.schedule）做跨重跑的参数传递，重跑时这些值会自动更新为重跑操作发生的时间，不会保留首次触发的取值
• 不推荐用缓存（Cache）存储运行参数，缓存有自动淘汰策略，且容易被同分支其他运行覆盖，稳定性远低于和Run ID绑定的工作流构件
• 如果是全新触发的工作流运行（不是从原失败Run入口重跑），属于新的任务实例，不会关联历史Run的构件，这类场景直接通过workflow_dispatch传入指定日期即可

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