WordPress Cron任务仅执行一次问题及控制台日志调试咨询

一、Cron任务仅显示一次的原因及解决方法 #

原因分析 #

1. WPCrontrol显示逻辑：WordPress Cron是事件触发机制，任务执行完成后会自动调度下一次运行。WPCrontrol插件只会展示下一次即将运行的任务，而非所有未来计划任务，所以你看到的“仅运行一次”是正常显示，并非任务真的只执行一次。
2. 全局调度代码的隐患：你直接在全局作用域调用wp_schedule_event()，每次主题/插件加载都会执行该函数。虽WordPress会避免重复添加相同任务，但这种写法不规范，可能在缓存场景或代码加载顺序异常时，导致调度逻辑失效。

修复方案 #

• 用激活钩子调度任务：将调度逻辑放在插件/主题的激活钩子中，确保仅在激活时执行一次调度，避免重复触发：

// 注册激活钩子
register_activation_hook(__FILE__, 'my_cron_activate');
function my_cron_activate() {
    // 检查任务是否已存在，避免重复调度
    if (!wp_next_scheduled('run_pdf_script_hook')) {
        wp_schedule_event(time(), '2min', 'run_pdf_script_hook');
    }
}

// 可选：注册停用钩子，清理任务
register_deactivation_hook(__FILE__, 'my_cron_deactivate');
function my_cron_deactivate() {
    wp_clear_scheduled_hook('run_pdf_script_hook');
}

• 确保自定义间隔生效：你的my_cron_schedules函数写法正确，需保证该函数在wp_schedule_event执行前被加载，不要将其放在过晚触发的钩子中。

二、控制台日志无法工作的原因与调试方法 #

原因分析 #

Cron任务是在服务器后台运行的，没有关联前端浏览器页面，你通过echo输出的<script>标签不会被浏览器解析，自然无法在控制台打印日志。

调试方案 #

方法1：写入PHP错误日志

直接将日志输出到服务器的PHP错误日志：

function run_pdf_script(){
    error_log('PDF脚本Cron任务执行：' . date('Y-m-d H:i:s'));
}

可通过服务器控制面板查看PHP错误日志，或在wp-config.php中配置自定义日志路径：

define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

配置后日志会写入wp-content/debug.log文件。

方法2：写入自定义日志文件

手动创建日志文件并追加内容：

function run_pdf_script(){
    $log_file = WP_CONTENT_DIR . '/cron_task_logs.txt';
    $log_content = '[' . date('Y-m-d H:i:s') . '] PDF脚本任务执行完成' . PHP_EOL;
    // 加锁追加写入，避免多进程冲突
    file_put_contents($log_file, $log_content, FILE_APPEND | LOCK_EX);
}

注意需确保wp-content目录有写入权限，否则会执行失败。

方法3：用WP-CLI手动触发调试

若有服务器命令行权限，可使用WP-CLI直接触发任务并查看输出：

wp cron event run run_pdf_script_hook

这种方式能直接看到任务执行时的输出，快速排查问题。

额外注意事项 #

• WordPress Cron的局限性：它依赖网站访问量，若网站长时间无访客，Cron任务会无法触发。低访问量网站建议改用系统级Cron（通过服务器控制面板或命令行配置），稳定性更高。
• 任务超时处理：若PDF脚本执行时间较长，可能被PHP超时限制中断，必要时可在代码中取消超时：

set_time_limit(0); // 仅在确认脚本安全时使用

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