jenkins 定时触发器完全依赖主节点系统时钟和时区，与代码源时间无关；需校准系统时间、统一时区配置、验证 next build time，三步解决漏触发问题。

Jenkins 定时触发器（Build periodically）本身不依赖外部代码源的时间，它完全基于 Jenkins 主节点（即构建机）的系统时钟执行。所谓“构建机物理时钟与外部代码源不一致导致漏触发”，这个前提存在误解——代码源（如 GitHub、GitLab）没有“时间”参与 Jenkins 的定时触发逻辑，Jenkins 的 cron 触发只看自己服务器的本地时间（或配置的时区）。

真正影响 Jenkins 定时任务是否“漏触发”的，是构建机自身的系统时间准确性和时区配置一致性。一旦构建机时间漂移、未同步、或时区设置错误，就会直接导致 cron 表达式计算出的触发时刻与预期不符，表现为“该执行却没执行”或“提前/延后执行”。

Jenkins

通过 REST API 与 Jenkins CI/CD 服务器交互。适用于触发构建、查询状态、查看控制台输出、管理任务或监控 Jenkins...

下载

以下是针对性解决路径：

确认并校准构建机系统时间

Jenkins 的调度器每分钟轮询一次 cron 表达式，严格依据系统 `date` 输出判断是否到点。若时间不准，所有定时任务都会偏移。

• 检查当前时间与标准时间偏差：

  date
  timedatectl status

• 强制同步时间（推荐使用 NTP）：

  sudo systemctl enable --now chronyd   # CentOS/RHEL 8+
  # 或
  sudo systemctl enable --now systemd-timesyncd  # Debian/Ubuntu
  sudo timedatectl set-ntp true

• 验证同步状态（等待几分钟后）：

  timedatectl timesync-status | grep "system clock"

统一 Jenkins 运行时区与系统时区

Jenkins 默认使用 JVM 启动时读取的系统时区。若系统时区为 `UTC`，但你在 Jenkins UI 中按 `Asia/Shanghai` 理解 cron 时间，就会产生 8 小时错位。

• 查看 Jenkins 实际识别的时区：
  • 访问 http://<jenkins-url>/systemInfo</jenkins-url> → 查找 user.timezone 或 Default TimeZone
• 确保系统时区设置正确：

  sudo timedatectl set-timezone Asia/Shanghai

• 若 Jenkins 以服务方式运行（如 systemd），还需在启动配置中显式指定 JVM 时区（避免依赖系统）：

  # /etc/default/jenkins 或 jenkins.service Environment=
  JAVA_OPTS="-Duser.timezone=Asia/Shanghai"

• 重启 Jenkins 生效：

  sudo systemctl restart jenkins

验证 cron 表达式在目标时区下的真实触发时刻

不要凭经验换算，用工具确认 Jenkins 实际理解的时间点。

• 在 Jenkins UI 中，进入任意任务 → “Configure” → “Build Triggers” → 填写你的 cron 表达式（如 0 9 * * 1-5）→ 页面下方会显示 Next build time（下一次构建时间），该时间已按 Jenkins 当前生效时区计算，具有权威性。
• 若显示时间明显错误（如显示 UTC 时间而非本地时间），说明时区未生效，需回溯上一步。

规避时区/时间依赖的增强实践

对关键业务任务，建议叠加一层防御性设计：

• 使用 H 符号分散负载的同时，也弱化对“绝对分钟”的强依赖（例如 H 9 * * 1-5 比 0 9 * * 1-5 更健壮，因只要当天 9 点整点窗口内某分钟触发即算成功）；
• 对必须精确到分秒的任务，改用 Pipeline + cron step 并配合日志打点：

  pipeline {
      agent any
      triggers {
          cron('0 9 * * 1-5')
      }
      stages {
          stage('Check Time') {
              steps {
                  script {
                      echo "Triggered at: ${new Date()}"
                      // 可追加校验：若距整点偏差 > 60s，warn 或 abort
                  }
              }
          }
      }
  }

不复杂但容易忽略：Jenkins 定时触发只忠于自己的钟，不是代码仓库的钟，也不是你电脑的钟。校准本机、锁死时区、看懂 Next build time —— 三步做完，漏触发问题基本归零。