定时任务实战总结：从基础到高级全面解析

定时任务搞不定，折腾半天发现是Node.js版本问题

最近在做一个后台管理系统，需要定期执行一些数据清理的任务。本来以为很简单，直接用node-cron库就能搞定，结果一上手就出问题了。

一开始的思路很简单

我先在项目里安装了node-cron库，然后写了这么一段代码：

const cron = require('node-cron');

cron.schedule('0 0 * * *', () => {
  console.log('Running a task every day at midnight');
  // 这里放具体的任务逻辑
});

想着这样就能每天凌晨执行一次任务了，结果运行起来啥反应都没有。我就开始各种排查，首先检查了时间格式有没有问题，确认无误后，又怀疑是不是node-cron版本的问题，于是更新了一下库，还是不行。

折腾了半天发现是Node.js版本问题

后来试了下把console.log改成写日志，发现日志文件里也没有任何输出。这就奇怪了，难道是环境问题？我检查了下Node.js版本，发现是14.17.6，心想这个版本应该没问题啊。但还是不死心，升级到16.x版本试试看，结果神奇的事情发生了，任务竟然正常运行了！

核心代码就这几行

最终的代码其实没怎么变，就是确保Node.js版本是最新的：

# 升级Node.js版本
nvm install 16
nvm use 16

然后重新运行之前的代码：

const cron = require('node-cron');

cron.schedule('0 0 * * *', () => {
  console.log('Running a task every day at midnight');
  // 具体的任务逻辑
});

这次终于看到控制台输出了“Running a task every day at midnight”，心里那个石头终于落地了。

技术细节和原理

这里我踩了个坑，node-cron库确实有版本兼容性问题。我在网上查了下，发现从Node.js 15.x版本开始，有一些底层的API发生了变化，而node-cron可能还没有完全适配。所以，如果你在使用node-cron时遇到类似问题，不妨先检查一下你的Node.js版本，尽量使用最新版本。

另外，node-cron的Cron表达式也很重要，一定要确保格式正确。标准的Cron表达式格式是：

分钟 小时 日 月 星期

例如0 0 * * *表示每天凌晨0点执行一次任务。

后续的一些小问题

虽然任务能正常运行了，但还有一个小问题是，每次重启服务器后，任务会丢失。为了解决这个问题，我决定把定时任务放在一个单独的服务里，让它持续运行，不受主应用重启的影响。

具体实现可以用pm2来管理进程，保证任务服务一直在线：

# 安装pm2
npm install -g pm2

# 启动定时任务服务
pm2 start cron-job.js --name "daily-cleanup"

总结

以上是我踩坑后的总结，如果你有更好的方案欢迎评论区交流。这个技巧的拓展用法还有很多，后续会继续分享这类博客。