WP Cron 健康监控器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_3c6cb52e/wp-cron-health-monitor
技能介绍
WordPress cron 任务的隐性风险
WordPress 的 wp-cron 机制依赖页面加载触发计划任务,而非持续运行的系统 cron。当网站流量较低时,任务可能因缺乏触发条件而延迟执行,甚至因长期未运行而"卡死"。此外,任务队列中可能存在孤立的条目,这些条目因依赖关系失效或逻辑错误而无法正常执行,但常规监控难以发现。对于依赖定时任务的插件(如备份、清理、推送功能),这些问题可能导致数据不一致或功能异常。
监控器的核心能力与工作逻辑
该技能通过 WP_Cron API 和 Action Scheduler 库深度整合 WordPress 的任务调度体系,实现以下核心能力:
- 实时任务检测:持续扫描
cron队列,识别处于"逾期"(overdue)或"未执行"(stuck)状态的任务,通过对比计划执行时间与实际执行状态实现精准判定。 - 异常分类与告警:区分"孤立任务"(
orphaned,即依赖关系已失效的任务)和"重复卡住"的任务,并通过 WP REST API 的 webhook 机制发送结构化告警,支持自定义阈值(如任务超时时间、连续失败次数)来触发通知。 - 可视化与可操作性:告警内容包含任务名称、计划时间、当前状态等关键字段,开发者可直接通过 API 响应定位问题任务,并结合 WordPress 后台或插件界面进行手动干预或修复。
适用场景与使用边界
该工具适用于需要精细化管理 WordPress 定时任务的场景,尤其适合:
- 运行依赖复杂 cron 逻辑的插件(如电商订单同步、会员过期提醒)的网站。
- 需满足合规性要求(如定期数据备份、日志清理)的企业级 WordPress 部署。
- 开发环境中用于验证任务调度逻辑的稳定性。
但需注意,该监控器本身不直接修复任务,仅提供检测与告警。对于高频任务(如每分钟执行的同步操作),需结合服务器日志和性能监控工具综合排查;对于分布式 WordPress 部署(如使用 Redis 缓存或负载均衡),需确保 webhook 端点能正确接收来自多节点的告警。此外,该工具不替代系统级监控(如服务器 CPU、内存指标),而是作为 WordPress 任务层的健康保障补充。
使用场景
- WordPress站点中备份、清理等cron任务未按时执行,需排查卡死或逾期的任务并触发告警
- 插件开发者需要验证自定义cron任务逻辑,检查任务是否被正确调度且未进入孤立状态
- 企业级WordPress部署需满足合规要求,需定期监控定时任务健康状态确保数据备份正常
- 分布式WordPress环境使用多节点部署,需通过webhook接收各节点的cron任务告警以统一排查
适合人员
- WordPress站点管理员:需确保站点的备份、会员过期提醒等定时任务正常运行,避免数据丢失或功能异常
- WordPress插件开发者:需要验证插件中cron任务的调度逻辑是否正确,避免任务卡死或依赖失效
- 负责WordPress站点运维的工程师:需要监控站点的cron任务健康状态,及时处理异常任务并接收告警
- 使用Action Scheduler库的开发者:需要检测任务队列中的孤立条目,确保复杂依赖关系下的任务正常执行