快捷導(dǎo)航

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

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

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

1. 簡(jiǎn)介

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

它是Unix系統(tǒng)cron工具的JavaScript實(shí)現(xiàn)，適用于需要定時(shí)執(zhí)行腳本的場(chǎng)景（如數(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個(gè)字段組成：

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

常用示例：

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

5. 高級(jí)功能

5.1 帶參數(shù)配置

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

5.2 任務(wù)控制

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

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

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

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

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

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

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

示例2：API定時(shí)請(qǐng)求

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);
});