Jenkins每周1次构建流水线定时触发未按预期生效问题咨询

1. 校验cron表达式正确性 #

Jenkins的Build periodically采用5位cron规则，格式为分 时 日 月 周，每周四凌晨1点的正确表达式为0 1 * * 4，优先检查以下配置问题：

• 周域取值是否正确：Jenkins中0和7代表周日，4才对应周四，不要填错数值
• 不要多写cron位数：Jenkins不支持6位带年份的cron格式，多写位数会直接导致规则失效
• 检查表达式是否有多余空格、错误注释符号等语法问题
• 配置页下方会自动展示下一次触发时间，直接确认该时间是否符合预期，如果显示错误直接修改表达式即可

2. 排查Jenkins服务侧问题 #

• 确认预期触发时间点Jenkins服务处于正常运行状态，没有关机、重启、服务中断等情况
• 核对Jenkins系统时区：Jenkins默认使用UTC时区，和北京时间相差8小时，如果时区配置错误会导致触发时间完全不符合预期。可进入「系统管理」-「系统信息」查看user.timezone参数，如需修改可在Jenkins启动参数中添加-Duser.timezone=Asia/Shanghai，重启后生效
• 确认内置Cron支持插件未被禁用，版本无兼容异常

3. 检查任务配置限制 #

• 确认任务本身未被禁用，禁用状态下定时规则不会生效
• 检查任务是否配置了并发构建限制：如果前一次构建还在运行且禁止并发，定时触发请求会被直接丢弃
• 核对参数构建类任务是否配置了默认参数：如果没有配置默认参数，定时触发时会因为参数缺失无法执行
• 查看任务构建历史和触发器日志：如果存在触发记录但构建失败，排查任务自身的构建脚本逻辑问题；如果完全没有触发记录，回到前两步排查表达式和服务问题

4. 快速验证方法 #

可先配置短周期测试表达式，比如* * * * *（每分钟触发一次），观察1-2分钟确认定时功能本身正常，再改回目标表达式，同时确认页面提示的下一次触发时间符合预期即可。

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