WordPress定时文章未发布:核对计划任务并接入系统调度

适用:WordPress单站点,Ubuntu 24.04 LTS,已安装与站点PHP兼容的WP-CLI。先确认文章状态为“已计划”(部分版本称“定时”),并在“设置→常规”核对站点时区。WordPress默认调度依赖网站访问触发,访问少的网站可能不能在预计时间执行任务。

一、区分时间设置与任务未执行

  1. 打开目标文章,记录计划发布时间和当前状态,不要反复改成新的时间掩盖问题。

    WordPress示例文章已计划状态,显示演示日期2026年11月16日09时UTC加0

    官方 WordPress Playground 隔离示例:临时文章显示“已计划”及计划发布时间。图中2026年11月16日09:00和UTC+0仅为演示日期、时间与时区,请按自己网站的实际发布安排设置,不要照抄。

  2. 在站点后台核对时区,再比较服务器时间。WP-CLI中的next_run_gmt是UTC时间,不能直接与北京时间混看。

    WordPress中文常规设置中的站点时区,演示实例当前为UTC+0

    官方 WordPress Playground 隔离示例:站点时区设置位置。图中UTC+0只是演示实例当前值,请按自己网站的业务时区设置,不要照抄。

  3. 使用网站原来的运行账号读取任务。示例目录须替换为实际WordPress根目录。
date -Is
wp --path=/www/wwwroot/site-example cron event list --fields=hook,next_run_gmt,next_run_relative,recurrence

文章发布对应的事件通常是publish_future_post。如果任务已过期却长期停留,继续检查调度;如果事件已运行但文章仍未发布,查看PHP及相关插件日志。不要把所有任务删除后重新生成。

二、检查是否已有系统调度

核对站点账号的crontab、服务器计划任务和wp-config.php。若已经有一条正常调用wp-cron.php或WP-CLI的任务,先修复它,不要再加第二条。DISABLE_WP_CRON=true只关闭访问触发的方式,不会自动创建替代任务。

wp cron test检测的是HTTP触发机制;已经主动关闭访问触发时,它提示被禁用是预期结果,不能据此认定系统cron失效。

三、用同一站点账号建立定期入口

下面以实际运行账号siteuser为例。该账号必须能读站点配置,并具备任务需要的文件权限。先运行command -v wp确定WP-CLI真实路径,不要默认所有服务器都在同一个位置。

mkdir -p /home/siteuser/.local/state/wp-cron
chmod 700 /home/siteuser/.local/state/wp-cron
command -v wp
wp --info
crontab -e

wp --info中的PHP binary和PHP version应符合本站要求。cron的PATH可能与登录Shell不同,面板多PHP环境尤其要先核实任务实际选用的PHP,必要时使用匹配的PHP绝对路径调用已确认的WP-CLI入口。然后在这个账号的crontab中保留一条入口,按实际路径替换:

* * * * * /usr/bin/flock -n /home/siteuser/.local/state/wp-cron/run.lock /usr/local/bin/wp --path=/www/wwwroot/site-example cron event run --due-now >> /home/siteuser/.local/state/wp-cron/run.log 2>&1

它每分钟检查一次到期任务,上一轮没结束时跳过本轮。--due-now会执行全部到期事件,可能包含邮件、导入或其他业务操作;启用前必须看懂现有任务清单,不要在测试时随意批量补跑正式业务。

确认新入口真实执行成功后,再编辑并备份wp-config.php,在加载WordPress之前设置:

define( 'DISABLE_WP_CRON', true );

已有同名设置时修改原行,不能重复定义。不要使用--skip-plugins作为日常调度参数,否则插件注册的任务处理器可能不加载。

四、用自己的测试文章验收

  1. 建立一篇明确标注“测试”的文章,安排在几分钟后发布;记录计划时间。
  2. 期间不靠反复刷新前台触发任务,观察系统任务日志和文章状态。
  3. 到期后确认文章已发布且没有PHP错误;本次单次发布事件应从队列移除,周期任务才会推进下一次执行时间。
  4. 检查站点原有备份或维护任务仍正常执行,完成后处理测试文章。

服务器负载、任务耗时和调度间隔都会影响实际时间,这不是秒级定时服务。若准备撤回新入口,先恢复访问触发,再移除新增cron行,避免两种方式都被关闭。需要处理指定卡住事件时,先查清对应业务和失败原因。

相关教程:Linux定时任务检查、服务器时间不准。