WordPress 定时发布失败排查:时区、WP-Cron 与执行日志
WordPress 文章显示“错过定时发布”,先核对文章状态和站点时区,再检查 WP-Cron 的触发与执行。低访问量可能让任务延迟,但回环请求被拦截、外部调度没有接好或插件报错,也会造成相同现象。直接换更大的 VPS,通常解决不了这些问题。

先分清:时间没到、没有发布,还是前台没更新
记录失败文章的 ID、后台计划时间、当前状态,以及“设置 → 常规”中的时区。草稿、待审核和私密文章不能当成已安排的公开定时文章。后台已经是“已发布”,而首页仍显示旧内容时,应检查文章正式网址、首页和 CDN 缓存,避免继续反复执行发布任务。
例如站点使用 UTC+8,计划上午 9:00 发布,对应的 UTC 时间是当天 01:00;不要把命令里的 next_run_gmt 直接当成香港时间。跨夏令时地区还应核对所选城市时区,固定 UTC 偏移不会自动跟随当地夏令时。
着急上线的已审阅文章,可以由有发布权限的编辑在后台确认后手动发布,再匿名打开正式页面验收。这能处理当前一篇文章,后续定时任务仍需继续排查。
默认 WP-Cron 需要请求触发
WP-Cron 负责 WordPress 的计划任务,包括定时文章和部分维护工作。它不是一直运行的系统时钟;请求进入 WordPress 后,程序才有机会检查到期事件。凌晨几乎无人访问的小站,可能到下一次有效请求时才执行任务。
仅由 CDN 或整页缓存返回的页面,未必会进入 WordPress 执行程序。因此“有访问量”不能单独证明触发正常;同样,持续刷新首页也不是可靠的修复方法。先到“工具 → 站点健康”查看计划事件与回环请求相关提示,再查看主机或应用日志。
用 WP-CLI 核对事件和触发,注意测试范围
有服务器终端和已安装 WP-CLI 时,由管理该站点的普通用户执行下面的示例;把 /path/to/wordpress 换成真实 WordPress 根目录。共享主机没有终端权限时,可以把文章 ID、计划时间、站点健康提示和失败日志交给主机商排查,不必为此先迁移网站。
wp --path=/path/to/wordpress cron event list --fields=hook,next_run_gmt,args --format=json
在结果中找 publish_future_post,并核对参数中的文章 ID 和下一次运行时间。只看到这个 hook 还不够:同一个名称可能对应多篇定时文章。事件不存在,应回到编辑器检查计划状态、重新保存计划并再查看;事件已过期,则继续追查触发与执行情况。
wp --path=/path/to/wordpress cron test
第二条命令会尝试通过 HTTP 触发 WP-Cron,可能带动到期任务,不能当成纯读取命令。成功结果只能说明这一次触发检查通过,不能证明每个回调都完成,或明天也一定准时发布。
如果 DISABLE_WP_CRON 已设为 true,该命令会报错。这时先确认站点是否有正常运行的系统定时任务或托管平台调度;这个配置可以是主动关闭页面触发,不能仅凭报错就判定外部调度失效。
根据证据处理:请求失败与任务报错分开查
- 返回登录页、403 或安全挑战:检查 HTTP 认证、安全插件、CDN/WAF 与主机限制是否挡住回环或外部调度请求。针对实际规则调整,不要直接关闭整个站点防护。
- 超时、DNS 或证书错误:从执行任务的服务器核对域名解析、HTTPS 证书、网络连通性与站点地址。个人电脑能打开网站,不代表源站能够向自己发出同样的请求。
- 请求到达但文章仍未发布:查看对应时间的 PHP 和应用错误日志,确认是否有插件回调异常、资源不足或权限问题。先在隔离环境定位组件,不在营业中的网站一次停用全部插件。
- 只有一个插件任务失败:检查该插件自己的队列、执行日志和依赖。它可能使用额外的调度机制;WP-Cron 正常不能代替插件业务结果验收。
不要为了清除提示直接删除全部 cron 事件、清空任务队列或批量执行 --all。补跑任务可能发送邮件、执行同步或提前处理尚未到期的工作,应先确认具体 hook、参数和业务影响。
需要系统调度时,先接通再关闭页面触发
低访问量网站如果需要更稳定的检查频率,可以使用主机面板或操作系统调度器定期调用 WordPress。先问清托管平台是否已经提供同类任务、允许的最短间隔和执行用户,避免多套调度重复运行。这里给出配置与验收顺序,具体命令需按主机面板、站点路径和 PHP 环境填写。
- 备份
wp-config.php,保存原有系统任务配置,并记录目前是否已有DISABLE_WP_CRON。 - 选择一种调用方式:向正式 HTTPS 的
/wp-cron.php发请求,或用正确 PHP/WP-CLI 环境执行到期任务。HTTP 方式受访问控制影响;命令行方式需核对 PHP 版本、扩展、用户和站点路径。 - 保留可查的执行时间、退出状态和错误输出,先验证新入口确实能运行,并确认任务结果;单独一个 HTTP 200 不证明文章已经发布。
- 新调度通过后,再在配置文件中设置
define( 'DISABLE_WP_CRON', true );,避免重复定义已有常量。它关闭的是默认页面触发,后台任务仍需要新的入口执行。 - 若新入口失败,恢复原配置中的页面触发并停用本次新增的系统任务,再检查未完成事件;原本已有外部调度的站点,应按改动前备份回退。
例如每 5 分钟检查一次,只表示提供这个频率的触发机会;任务耗时、并发锁、失败重试与服务器状态仍会影响完成时间,不能承诺精确到秒。多站点安装还要逐站核对任务范围,不能假定一次调用覆盖所有子站。
修复后,用一篇测试文章走完发布路径
在隔离测试站安排一篇无敏感内容、无真实通知和外部推送的测试文章,记录计划时间、实际发布状态和调度日志。可以先减少人工访问,观察新的调度入口是否独立生效。生产站如需验证,须先控制订阅通知、社交同步等联动,避免测试内容被自动外发。
- 文章从计划状态变为已发布,后台时间与站点时区一致。
- 匿名打开正式文章、首页或栏目,能看到正确内容;缩略图加载正常,旧缓存已处理。
- 调度日志没有持续报错,后续到期事件能继续处理,没有明显积压。
- 相关插件的备份文件、处理结果或测试通知确实产生,而不只是事件从列表消失。
如果问题确实是主机不提供所需的调度权限,选主机时再比较管理方式与限制;可先看WordPress 虚拟主机与 VPS 对比:RackNerd 方案及费用。VPS 能自行配置不代表有人代为维护,单纯增大内存也不会自动修复定时任务。