WordPress Cron钩子挂载与运行失效问题咨询

核心运行逻辑本质 #

WordPress的定时任务（WP-Cron）机制分为任务调度写入和任务触发执行两个完全独立的请求生命周期，二者不会共享PHP进程内的钩子注册状态。

第一版代码失效的具体原因 #

最初的代码把cron回调注册逻辑放在了表单提交的判断块内：

if (isset($_REQUEST['button_update_products'])) :
   add_action('admin_head', function () {wp_schedule_single_event(time() + 50,'t_cron_now');});
   add_action('t_cron_now', function () {...do something}); // 仅在表单提交请求内注册
endif;

点击Update按钮提交表单的那次请求中，实际执行流程是：

1. 判断条件成立，先注册admin_head钩子的回调，等页面渲染到admin_head阶段时，执行wp_schedule_single_event往WordPress数据库的cron队列写入一条「50秒后触发t_cron_now钩子」的调度记录——这一步确实执行成功，所以能在Crontrol插件里看到这条调度任务。
2. 同一次请求里确实注册了t_cron_now的回调，但这个注册只在当前表单提交的请求生命周期内有效。等这次请求返回响应，PHP进程回收，所有运行时注册的钩子、临时变量都会被完全销毁，不会留存到50秒之后。

50秒后定时任务到期时，只要有任意用户访问WordPress站点（前台、后台均可），WP-Cron就会自动启动检查到期任务：

• 这是一个全新的请求，请求里完全没有button_update_products这个POST参数，写的if判断根本不会成立，挂载t_cron_now回调的代码完全不会执行
• WP-Cron找到数据库里待执行的t_cron_now钩子后，发现没有任何绑定的回调函数，自然不会执行业务逻辑，这就是回调未挂载的根本原因。

调整后代码正常运行的原因 #

把回调注册代码挪到if判断外之后：

if (isset($_REQUEST['button_update_products'])) :
   add_action('admin_head', function () {wp_schedule_single_event(time() + 50,'t_cron_now');});
endif;

add_action('t_cron_now', function () {...do something}); // 全局注册，所有请求都会执行

所有请求加载插件时，都会无条件执行t_cron_now钩子的回调注册逻辑，不管请求是不是表单提交触发的。等50秒后cron触发的新请求到来时，回调已经提前挂载到钩子上，WP-Cron触发钩子时就能正常找到并执行回调，功能自然正常。

开发注意事项 #

• 所有自定义WP-Cron钩子的回调注册代码必须放在全局作用域，不能包裹在仅特定场景触发的条件判断块（比如表单提交判断、特定页面判断、管理员登录判断）中，因为cron触发的独立请求不会满足这些特殊条件。
• wp_schedule_single_event、wp_schedule_event这类调度函数本质只是往数据库写入一条待执行的任务记录，不会帮你持久化存储对应的回调函数，回调必须在每次请求初始化时完成注册。

内容的提问来源于stack exchange，提问作者JayFry