cron表达式0 9-17 * * *设置每日9-17点执行仅首日生效问题排查

问题原因及修复方案 #

你写的0 9-17 * * * cron表达式本身符合标准Linux cron规则，触发逻辑是每天9点到17点的每小时0分执行，出现仅首日触发的问题通常是以下几个原因导致：

• 异步回调未捕获异常导致任务终止 #

你使用了async作为回调函数，如果函数内部抛出未被捕获的错误，会直接导致该定时任务实例被销毁，后续所有调度都会停止。需要在async函数内部添加try/catch包裹业务代码，避免异常冒泡中断任务：

const job = schedule.scheduleJob("0 9-17 * * *", async () => {
  try {
    // 你的业务代码
  } catch (err) {
    // 自行处理错误，不要向外抛出
    console.error('定时任务执行出错', err)
  }
})

• 时区不匹配导致触发时间不符合预期 #

你使用的node-schedule库默认读取运行环境的系统时区，如果服务器时区和你预期的时区不一致，会出现看似没有触发的情况。比如你预期按东八区时间执行，服务器用UTC时区，你设置的9-17点对应UTC的1-9点，很容易被误以为次日没有触发。可以显式指定时区确保符合预期：

// 6位cron表达式第一位为秒，此处指定东八区时区
const job = schedule.scheduleJob("0 0 9-17 * * *", {
  tz: 'Asia/Shanghai'
}, async () => {
  // 你的业务代码
})

• 依赖库版本存在已知bug #

node-schedule 1.x的部分老版本存在跨日调度失效的问题，你可以尝试升级到最新稳定版后重试：
npm install node-schedule@latest

• 进程异常退出后任务未重新注册 #

如果你的服务在运行过程中发生过崩溃、重启，定时任务不会自动恢复，也会出现后续没有触发的情况，需要你自行实现任务持久化逻辑，进程启动时重新注册对应定时任务。

内容的提问来源于stack exchange，提问作者N.A