求助：在WordPress插件中正确配置Cron任务遇到问题

我明白你在禁用默认WordPress Cron后，配置自定义5分钟间隔任务时遇到了麻烦，咱们一步步来把问题捋清楚、解决掉。

首先，先确认你的自定义调度间隔代码是否完整——从你给出的片段来看，可能漏掉了返回修改后的$schedules数组，这是注册自定义间隔的关键。先给你完整的自定义调度注册代码：

// 注册自定义5分钟Cron调度间隔
add_filter('cron_schedules', 'my_custom_cron_schedules');
function my_custom_cron_schedules($schedules) {
    // 检查是否已存在5分钟间隔，避免重复注册
    if (!isset($schedules['5min'])) {
        $schedules['5min'] = array(
            'interval' => 5 * 60, // 换算成秒，300秒=5分钟
            'display' => __('每5分钟执行一次')
        );
    }
    // 必须返回修改后的数组，否则自定义间隔不会生效
    return $schedules;
}

接下来，你需要把任务和这个调度绑定，并且确保插件激活时自动注册任务、停用时清理任务，避免残留无效任务：

// 插件激活时注册Cron任务
register_activation_hook(__FILE__, 'my_activate_cron_task');
function my_activate_cron_task() {
    // 先检查任务是否已调度，避免重复添加
    if (!wp_next_scheduled('my_5min_cron_hook')) {
        wp_schedule_event(time(), '5min', 'my_5min_cron_hook');
    }
}

// 插件停用时清除已注册的Cron任务
register_deactivation_hook(__FILE__, 'my_deactivate_cron_task');
function my_deactivate_cron_task() {
    wp_clear_scheduled_hook('my_5min_cron_hook');
}

// 定义Cron任务触发时要执行的具体逻辑
add_action('my_5min_cron_hook', 'my_cron_task_function');
function my_cron_task_function() {
    // 这里替换成你实际要执行的代码，比如数据同步、日志记录等
    error_log('自定义5分钟Cron任务执行成功：' . date('Y-m-d H:i:s'));
}

关键注意事项（禁用默认WP Cron后的核心操作） #

当你在wp-config.php中添加了define('DISABLE_WP_CRON', true);后，WordPress不会再通过用户访问自动触发Cron任务了，必须依赖系统级的Cron来主动触发：

以Linux服务器为例，你需要添加系统Cron任务（通过crontab -e编辑）：

*/5 * * * * wget -q -O - https://你的网站域名/wp-cron.php?doing_wp_cron > /dev/null 2>&1

如果服务器不支持wget，也可以用curl替代：

*/5 * * * * curl -s https://你的网站域名/wp-cron.php?doing_wp_cron > /dev/null 2>&1

常见排查点 #

• 确保你重新激活过插件：register_activation_hook只有在插件激活时才会执行，如果你只是修改代码没重新激活，任务可能没注册成功。
• 验证自定义调度是否生效：可以用WP Crontrol这类插件查看已注册的Cron调度，确认“5min”间隔存在。
• 检查服务器权限：确保服务器允许wget/curl访问你的网站域名，部分主机有安全限制会阻止这类请求。
• 查看错误日志：如果任务没执行，检查服务器的PHP错误日志或WordPress的debug日志（开启WP_DEBUG_LOG），排查具体报错。

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