使用node-cron实现Node.js定时任务

1. 简介

node-cron 是一个轻量级的Node.js库，用于在指定时间或间隔执行任务。它是Unix系统cron工具的JavaScript实现，适用于需要定时执行脚本的场景（如数据备份、定期爬虫等）。

2. 安装

bash 复制代码

npm install node-cron
# 或
yarn add node-cron

3. 基础用法

javascript 复制代码

import cron from 'node-cron';

// 每分钟执行
cron.schedule('* * * * *', () => {
  console.log('每分钟触发');
});

4. Cron表达式详解

表达式由5个字段组成：

复制代码

*    *    *    *    *
┬    ┬    ┬    ┬    ┬
│    │    │    │    │
│    │    │    │    └── 星期几 (0 - 7) (0和7代表周日)
│    │    │    └────── 月份 (1 - 12)
│    │    └────────── 日期 (1 - 31)
│    └────────────── 小时 (0 - 23)
└─────────────────── 分钟 (0 - 59)

常用示例：

表达式	说明
`/5 * * *`	每5分钟
`0 * * * *`	每小时整点
`0 0 * * *`	每天午夜
`0 9 * * 1-5`	工作日早上9点
`30 3 15 * *`	每月15日凌晨3:30

5. 高级功能

5.1 带参数配置

javascript 复制代码

const task = cron.schedule('*/10 * * * *', () => {
  console.log('每10分钟执行');
}, {
  scheduled: true,       // 是否立即启动
  timezone: 'Asia/Shanghai' // 时区设置
});

5.2 任务控制

javascript 复制代码

// 暂停任务
task.stop();

// 恢复任务
task.start();

// 检查任务状态
console.log(task.getStatus()); // 返回 'running' 或 'stopped'

6. 实际应用示例

示例1：每日数据清理

javascript 复制代码

import cron from 'node-cron';
import cleanupDatabase from './cleanup.js';

// 每天凌晨3点清理
cron.schedule('0 3 * * *', () => {
  console.log('开始数据库清理...');
  cleanupDatabase();
});

示例2：API定时请求

javascript 复制代码

import axios from 'axios';

// 每30分钟获取天气数据
cron.schedule('*/30 * * * *', async () => {
  const res = await axios.get('https://api.weather.com/data');
  console.log('天气数据:', res.data);
});

7. 注意事项

精度问题：Node.js事件循环可能导致最多几毫秒的延迟
错误处理：务必在任务函数中添加try/catch
长任务：避免任务执行时间超过间隔时间
集群环境：在多进程部署时需要额外处理防止重复执行

8. 替代方案

node-schedule：更复杂的调度规则
bull：分布式任务队列
系统级cron：通过child_process调用

🚀 提示：在生产环境中建议添加日志记录和监控，可以使用winston或bunyan记录任务执行情况。

参考资料：

node-cron官方文档：https://github.com/node-cron/node-cron
Cron表达式标准：IEEE Std 1003.1

点个收藏，关注前端结城，一起用代码点亮前端世界！🚀