使用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. 注意事项

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

8. 替代方案

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

🚀 提示 :在生产环境中建议添加日志记录和监控,可以使用winstonbunyan记录任务执行情况。

参考资料:

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

相关推荐
EndingCoder21 小时前
MongoDB基础与Mongoose ODM
服务器·javascript·数据库·mongodb·中间件·node.js
孟陬1 天前
Bun 1.2.23发布:119个问题修复,性能飙升!
node.js·deno·bun
Q_Q19632884751 天前
python+uniapp基于微信美食点餐系统小程序
spring boot·python·微信·django·flask·uni-app·node.js
疯狂踩坑人1 天前
别再说我不懂Node"流"了
后端·node.js
陈振wx:zchen20081 天前
前端-Node.js
node.js
Q_Q19632884752 天前
python+uniapp基于微信小程序的助眠小程序
spring boot·python·小程序·django·flask·uni-app·node.js
孟陬2 天前
事件驱动 vs 轮询:为什么 Node.js 官方推荐 `fs.watch()` 而非 `fs.watchFile`
node.js
林希_Rachel_傻希希2 天前
Express 入门全指南:从 0 搭建你的第一个 Node Web 服务器
前端·后端·node.js
Q_Q5110082853 天前
python+uniapp基于微信小程序团购系统
spring boot·python·微信小程序·django·uni-app·node.js·php
云枫晖3 天前
深入浅出npm:现代JavaScript项目基石
前端·javascript·node.js