GitLab CI/CD定时任务重复执行问题：无变更时如何阻止重复触发？

先排查重复执行的根源 #

• 检查定时任务列表：进入项目「CI/CD」→「Schedules」，确认是否存在重复创建的定时任务（比如同分支、同cron表达式的多条记录），有则删除多余条目。
• 核对cron表达式：比如* * * * *是每分钟执行，若你需要每天一次，应该用0 0 * * *，避免因表达式写错导致高频触发。
• 查看Pipeline触发源：进入「CI/CD」→「Pipelines」，点击重复执行的Pipeline详情，查看「Triggered by」字段，确认是否是定时任务触发，还是手动、webhook等其他来源。

无变更时阻止任务执行的实现方法 #

方法1：通过GitLab API对比上次成功提交ID #

在.gitlab-ci.yml中添加逻辑，调用API获取同分支下该任务上次成功执行的提交ID，与当前提交ID对比，一致则退出任务：

scheduled_task:
  only:
    - schedules
  script:
    - |
      # 获取同分支最近一次成功Pipeline的提交ID
      LAST_SUCCESS_SHA=$(curl --silent --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
        "$CI_API_V4_URL/projects/$CI_PROJECT_ID/pipelines?scope=success&ref=$CI_COMMIT_BRANCH&per_page=1" \
        | jq -r '.[0].sha')
      
      # 对比提交ID，无变更则退出
      if [ "$CI_COMMIT_SHA" = "$LAST_SUCCESS_SHA" ]; then
        echo "No new commits since last run. Exiting."
        exit 0
      fi

      # 这里写你的实际任务脚本
      echo "Executing scheduled task..."
  variables:
    GITLAB_API_TOKEN: "$GITLAB_API_TOKEN" # 需在项目「Settings」→「CI/CD」→「Variables」中添加带api权限的个人访问令牌

方法2：用缓存存储上次执行标记（无需API） #

通过缓存保存上次执行的提交ID，下次任务启动时读取对比，无变更则退出：

scheduled_task:
  only:
    - schedules
  cache:
    key: "$CI_COMMIT_BRANCH-scheduled-cache"
    paths:
      - last_run_sha.txt
  script:
    - |
      if [ -f last_run_sha.txt ]; then
        LAST_RUN_SHA=$(cat last_run_sha.txt)
        if [ "$CI_COMMIT_SHA" = "$LAST_RUN_SHA" ]; then
          echo "No changes detected. Exiting task."
          exit 0
        fi
      fi

      # 执行你的任务逻辑
      echo "Running scheduled task..."

      # 更新缓存中的提交ID
      echo "$CI_COMMIT_SHA" > last_run_sha.txt

方法3：针对特定文件变更触发（适合文件驱动的任务） #

如果任务只需要在特定文件变更时执行，可结合rules和changes关键字（注意定时任务需显式配置）：

scheduled_task:
  rules:
    - if: '$CI_PIPELINE_SOURCE == "schedule"'
      changes:
        - src/**/*
        - config/*.yaml
      when: always
    - if: '$CI_PIPELINE_SOURCE == "schedule"'
      when: never

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