定时发布是 WordPress 的老功能:写好文章、选好时间、点「定时发布」,到点自动上线。但很多站长第一次重度使用时都会撞上同一个坑——排程时间到了,文章还是「计划」状态,前台 404,后台不报错,唯一的机会窗口就这么错过了。笔者某次排程发布后,就遇上了文章未如期出现。这篇文章把排查、根因、根治一次讲透。
一、先理解:WP-Cron 是个「假 cron」
很多人以为 WordPress 有个后台进程在守着时间发布文章,其实不是。WordPress 的定时机制叫 WP-Cron,它不是系统级定时器,而是靠访客访问触发:每次有人打开页面,WordPress 都会检查 cron 队列里有没有到期的事件,有就顺手执行掉。
这个设计的推论很关键:低流量的站点(尤其新站、夜间时段),事件到了点也可能因为「没人来」而不被执行。凌晨两点排程的文章,可能要等到早上第一位访客敲门才发布。这就是很多人误以为「WordPress 定时发布不稳定」的真正原因——不是不稳定,是触发链本来就不可靠。
cron 队列存在数据库 wp_options 表的 cron 字段里,装了 WP-CLI 的话用 wp option get cron 就能看,排错全靠它。
二、排查清单(按命中率排序)
1. wp-config.php 里有没有 DISABLE_WP_CRON
不少性能优化教程会教你往 wp-config.php 加这一行:
define('DISABLE_WP_CRON', true);
它的本意是省掉每次页面请求时检查 cron 的开销,但加了这行之后,按需触发就全断了,必须自己配系统 cron 替代。如果加了它却没配替代方案,定时发布就永远不会执行——这是命中率最高的一种死法,而且症状完全符合「不报错、就是不动」。
2. 查 cron 队列有没有过期事件
直接读队列,看 publish_future_post 事件的时间戳是否已经过了当前时间(也就是 OVERDUE)。如果队列里堆着好几条过期事件,说明触发链断了实锤;如果连事件都没有,那是排程本身没写进去,问题在另一半。
3. doing_cron 锁
WP-Cron 执行时会留一个 10 分钟的锁(防止并发重复执行)。如果某次执行中途中断,锁可能留下,期间新的触发会被跳过。正常会自愈,持续挂死才需要手动清理 doing_cron 这个 transient。
4. 时间戳时区坑(脚本排程的人重点看)
WP 的事件队列用 UTC 时间戳,文章的 post_date 用站点本地时间。手动写 SQL 或 PHP 脚本排程时,最容易在这里翻车——笔者就曾把 UTC 串当本地时间传给 wp_update_post,事件整体偏移 8 小时,测试稿一晚没动静,查了两轮才定位。下一节展开。
三、根治:crontab 兜底方案
排查下来,笔者的站点是两个问题叠加:配置里早就加过 DISABLE_WP_CRON,而系统 crontab 又是空的——等于双触发路径全断,定时发布彻底停摆。根治方案是保持 DISABLE_WP_CRON 不变(省掉每次页面请求的开销),用系统 cron 每 5 分钟兜底:
*/5 * * * * curl -s "https://你的域名/wp-cron.php?doing_wp_cron" >/dev/null 2>&1
效果立竿见影:定时发布的最大延迟从「不可预期」变成「约 5 分钟」——事件到期后,最多等下一轮 cron 触发就会执行。
验证方法也很简单:建一篇 5 分钟后的 future 测试稿,到点刷新看是否自动转成「已发布」。笔者验证时,事件到期后不到半分钟就完成了状态切换。测试稿验证通过后删掉即可。
四、手动排程的正确姿势
需要用脚本批量排程的话,记住一条铁律:post_date = 站点本地时间(中国站 +8),post_date_gmt = UTC,两个字段必须配对写,不能混用。PHP 侧的正确写法:
$gmt = gmdate('Y-m-d H:i:s', time() + 300); // 5 分钟后,UTC
$local = get_date_from_gmt($gmt); // 自动换算成本地时间
wp_update_post(array(
'ID' => $post_id,
'post_status' => 'future',
'post_date' => $local,
'post_date_gmt' => $gmt,
));
错误示范:current_time('timestamp') 的返回值拿去用 gmdate() 格式化——前者的返回值已经是本地时区语义,再用 UTC 函数格式化必然偏移时区。这类错误不报错、不警告,只有文章不出现时才会被发现,是最阴的一类。
五、防再犯机制
光修一次不算完,建议加三道防线:
- 排程后自检:每次脚本排程完,60 秒后读回
post_status,确认排程真的写进去了; - 次日核对:固定在每天同一时间核对「昨天定时发布的文章是否如期上线」,把问题发现窗口从「读者投诉」提前到「次日例行」;
- 排程避开触发沿:把排程时间设在整点后几分钟(比如 15:05),错开每 5 分钟的 crontab 触发点,避免「刚排程就赶上触发但事件还没 ready」的一轮空转。
结语
WordPress 定时发布「不稳定」,九成不是 WP 的锅,是触发链断了。摸清 WP-Cron 的模拟本质,加一条 crontab 兜底,这个问题就永远消失了——剩下的时间戳坑,属于写脚本时的纪律问题,配对好 post_date / post_date_gmt 即可绕开。
相关阅读:WordPress 升级后白屏、按钮失效的排查清单、WordPress 文章 ID 不连续的原因与解决方法。