萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

阿里雲 Cron 服務說明:分布式定時任務 API 與 Crontab 語法全解析

阿里雲 ACE 平台提供的 Cron 服務為開發者提供 分布式定時任務調度 能力,語法與 Linux crontab 完全兼容,但通過 PHP API 管理而非編輯檔案。本文詳細說明使用規則、API 文檔、調度語法、執行限制與最佳實踐。

核心特性

  • 語法兼容:標準 crontab 6 欄位格式 (分 時 日 月 周)
  • HTTP 觸發:到時以 HTTP 請求回呼應用內 PHP 腳本
  • API 管理:cron_add/cron_delete/cron_list 動態管理
  • 僅對預設版本生效:灰度/測試版本不執行定時任務
  • 執行超時:單次執行最長 30 秒,超時強制終止
  • 失敗自動清理:連續 5 次失敗 (非 2xx 狀態碼) 自動刪除該任務

Crontab 語法速查 (6 欄位)

*    *    *    *    *    *
│    │    │    │    └─ 星期 (0-6) (0=週日)
│    │    │    └──── 月份 (1-12)
│    │    └────── 日期 (1-31)
│    └───────── 小時 (0-23)
└──────────── 分鐘 (0-59)

常用範例

排程表達式含義
0 2 * * * *每天 02:00 執行
*/5 * * * * *每 5 分鐘執行
0 */2 * * * *每 2 小時整點執行
0 9-18/2 * * 1-5 *工作日 9-18 點每 2 小時
30 3 1 * * *每月 1 號 03:30
2/5 12-14 * * * *每天 12-14 點,從 2 分開始每 5 分鐘 (官方示例)

API 文檔

1. cron_add - 新增定時任務

string cron_add(string $scheduler, string $url [, string $timezone = 'GMT-8'])

參數:

  • $scheduler:crontab 表達式 (6 欄位)
  • $url:相對應用根目錄的腳本路徑,如 cron/backup.php
  • $timezone:時區,預設 GMT-8 (北京時間)

返回:成功返回 cron_id (字串),失敗返回 false

2. cron_delete - 刪除定時任務

bool cron_delete(string $cron_id)

返回:成功 true,失敗 false

3. cron_list - 查詢所有任務

array cron_list()

返回:成功返回陣列:

[
  ['cronId'=>'1', 'app_id'=>'2', 'url'=>'cron/back.php', 
   'scheduler'=>'2/5 12-14 * * * *', 'timezone'=>'gmt-8'],
  ...
]

失敗返回 false

參考示例

<?php
// 初始化腳本中配置 (如 bootstrap.php / install.php)

// 每天凌晨 2 點備份資料庫
$backup_id = cron_add('0 2 * * * *', 'cron/backup.php');

// 每小時清理過期緩存
$clean_id = cron_add('0 * * * * *', 'cron/clean_cache.php');

// 每週一 03:00 產生報表
$report_id = cron_add('0 3 * * 1 *', 'cron/weekly_report.php');

// 查詢現有任務
$tasks = cron_list();
var_dump($tasks);

// 刪除任務 (如需動態管理)
# cron_delete($backup_id);
?>

執行機制與限制深度解析

HTTP 回呼流程

  1. 調度器到達執行時間
  2. 向 https:/// 發起 GET 請求
  3. 應用路由分發至對應 Controller/Action
  4. 腳本執行 (最長 30 秒)
  5. 返回 HTTP 狀態碼:2xx = 成功,其他 = 失敗

30 秒超時應對策略

  • 任務拆分:大任務拆為多個小任務,鏈式觸發
  • 異步化:Cron 僅發送訊息至隊列 (Redis List / RocketMQ),Worker 後台消費
  • ignore_user_abort(true); set_time_limit(0); 在 ACE 無效,受平台層面限制

連續 5 次失敗自動刪除機制

  • 判斷依據:HTTP 狀態碼非 2xx (含 3xx、4xx、5xx、超時、連接失敗)
  • 防止殭屍任務佔用調度資源
  • 建議:腳本開頭記錄日誌、捕獲異常、確保返回 200 OK (即使業務邏輯失敗也返回 200,內容體標記錯誤)

最佳實踐模式

模式一:冪等性設計

<?php
// cron/daily_bill.php
$date = date('Y-m-d', strtotime('-1 day'));
$lock_key = "cron:daily_bill:$date";
$mem = new Memcache(); $mem->init();

if (!$mem->add($lock_key, 1, 0, 86400)) {
    exit("Already executed"); // 重複執行直接退出
}

try {
    $billing->generateDailyBill($date);
    $mem->set($lock_key, 2, 0, 86400); // 標記完成
    echo "OK";
} catch (Exception $e) {
    error_log($e->getMessage());
    echo "FAILED: " . $e->getMessage(); // 仍返回 200,避免被刪除
}
?>

模式二:偏移執行避開峰值

# 錯誤:所有租戶都在 0 0 * * * 執行備份 → 存儲/網路風暴
# 正確:引入隨機偏移
cron_add('*/30 2-4 * * *', 'cron/backup.php'); // 凌晨 2-4 點隨機半小時執行

模式三:動態任務管理

// 後台管理介面動態增刪任務
// 新增
$cid = cron_add($schedule, $script);
// 刪除
cron_delete($cid);
// 列表
$list = cron_list();

遷移指南:從 Linux crontab 到 ACE Cron

傳統 crontabACE Cron
編輯 /etc/crontab 或 crontab -ePHP 代碼調用 cron_add()
直接執行 Shell/腳本HTTP 觸發 PHP 腳本
標準輸出/錯誤導向檔案error_log() / 存入資料庫 / 發送郵件
環境變數在 crontab 定義應用配置/環境變數/配置中心
單機單點故障分布式調度,高可用

常見問題

  1. 任務不執行:檢查應用是否為預設版本、URL 路徑是否正確、腳本是否可公開訪問 (無需登入)
  2. 執行超時:拆分任務、異步隊列、優化 SQL/邏輯
  3. 時區錯誤:明確指定 timezone='GMT-8',勿依賴預設
  4. 並發衝突:使用 Memcache/Redis 分布式鎖保證單次執行

ACE Cron 將定時任務從「作業系統層面」提升至「應用層面」,配合分布式調度與 HTTP 觸發模型,讓定時任務具備與應用同等的彈性伸縮與高可用能力。

copyright © 萬盛學電腦網 all rights reserved