使用node-cron實現(xiàn)Node.js定時任務(wù)方式

更新時間：2025年10月25日 13:48:53 作者：結(jié)城

node-cron是一個輕量級的Node.js庫,用于在指定時間或間隔執(zhí)行任務(wù),它支持Cron表達(dá)式,適用于定時任務(wù)場景,文章還介紹了基礎(chǔ)用法、高級功能、實際應(yīng)用示例以及注意事項

1. 簡介

node-cron 是一個輕量級的Node.js庫，用于在指定時間或間隔執(zhí)行任務(wù)。

它是Unix系統(tǒng)cron工具的JavaScript實現(xiàn)，適用于需要定時執(zhí)行腳本的場景（如數(shù)據(jù)備份、定期爬蟲等）。

2. 安裝

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

3. 基礎(chǔ)用法

import cron from 'node-cron';

// 每分鐘執(zhí)行
cron.schedule('* * * * *', () => {
  console.log('每分鐘觸發(fā)');
});

4. Cron表達(dá)式詳解

表達(dá)式由5個字段組成：

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

常用示例：

表達(dá)式	說明
/5 * * *	每5分鐘
0 * * * *	每小時整點
0 0 * * *	每天午夜
0 9 * * 1-5	工作日早上9點
30 3 15 * *	每月15日凌晨3:30

5. 高級功能

5.1 帶參數(shù)配置

const task = cron.schedule('*/10 * * * *', () => {
  console.log('每10分鐘執(zhí)行');
}, {
  scheduled: true,       // 是否立即啟動
  timezone: 'Asia/Shanghai' // 時區(qū)設(shè)置
});

5.2 任務(wù)控制

// 暫停任務(wù)
task.stop();

// 恢復(fù)任務(wù)
task.start();

// 檢查任務(wù)狀態(tài)
console.log(task.getStatus()); // 返回 'running' 或 'stopped'

6. 實際應(yīng)用示例

示例1：每日數(shù)據(jù)清理

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

// 每天凌晨3點清理
cron.schedule('0 3 * * *', () => {
  console.log('開始數(shù)據(jù)庫清理...');
  cleanupDatabase();
});

示例2：API定時請求

import axios from 'axios';

// 每30分鐘獲取天氣數(shù)據(jù)
cron.schedule('*/30 * * * *', async () => {
  const res = await axios.get('https://api.weather.com/data');
  console.log('天氣數(shù)據(jù):', res.data);
});