如何让WordPress的post_date字段匹配WP CRON定时发布时间？

核心思路 #

WordPress定时发布的文章默认会把post_date设为创建时的预定发布时间，但CRON触发发布的实际时间才是用户需要的「发布时间」。我们可以通过钩子拦截发布事件，修改post_date或自定义存储实际发布时间来解决。

方案1：直接更新post_date为实际发布时间 #

利用publish_post钩子（文章转为发布状态时触发，包含CRON触发定时发布的场景），在文章发布时将post_date和post_date_gmt更新为当前时间（即CRON触发的实际发布时间）。

add_action('publish_post', 'update_post_date_to_actual_publish_time', 10, 2);
function update_post_date_to_actual_publish_time($post_id, $post) {
    // 仅处理从future状态转为publish的定时发布文章，避免手动立即发布的情况被修改
    if ($post->post_status !== 'publish' || get_post_meta($post_id, '_wp_old_status', true) !== 'future') {
        return;
    }
    
    // 获取当前本地时间和UTC时间，匹配WordPress存储格式
    $current_local_time = current_time('mysql');
    $current_gmt_time = current_time('mysql', 1);
    
    // 更新文章日期字段
    wp_update_post([
        'ID' => $post_id,
        'post_date' => $current_local_time,
        'post_date_gmt' => $current_gmt_time
    ]);
    
    // 清除旧状态的元数据，避免重复触发
    delete_post_meta($post_id, '_wp_old_status');
}

说明：

• 钩子优先级设为10，确保在默认发布逻辑之后执行
• 通过_wp_old_status元数据精准定位定时发布场景（从future转为publish）
• 更新后所有依赖get_the_date()的显示逻辑会自动使用实际发布时间，无需额外修改

方案2：自定义字段存储实际发布时间（不修改默认post_date） #

如果担心修改post_date影响其他依赖该字段的功能（如RSS订阅、归档排序），可以用自定义字段存储实际发布时间，再通过过滤器覆盖显示逻辑。

// 存储实际发布时间到自定义字段
add_action('publish_post', 'save_actual_publish_timestamp', 10, 2);
function save_actual_publish_timestamp($post_id, $post) {
    if (get_post_meta($post_id, '_wp_old_status', true) !== 'future') {
        return;
    }
    
    // 存储UTC时间戳，避免时区问题
    update_post_meta($post_id, '_actual_publish_time', current_time('timestamp', 1));
}

// 覆盖get_the_date的返回值
add_filter('get_the_date', 'use_actual_publish_date', 10, 3);
function use_actual_publish_date($display_date, $date_format, $post) {
    $actual_timestamp = get_post_meta($post->ID, '_actual_publish_time', true);
    if ($actual_timestamp) {
        // 转换为本地时间并按指定格式输出
        $display_date = date_i18n($date_format ?: get_option('date_format'), $actual_timestamp);
    }
    return $display_date;
}

// 覆盖"多久前"的时间差计算
add_filter('human_time_diff', 'use_actual_publish_time_diff', 10, 4);
function use_actual_publish_time_diff($time_diff_text, $from, $to, $raw_diff) {
    global $post;
    if (!$post) return $time_diff_text;
    
    $actual_timestamp = get_post_meta($post->ID, '_actual_publish_time', true);
    if ($actual_timestamp) {
        $time_diff_text = human_time_diff($actual_timestamp, current_time('timestamp'));
        return sprintf(__('%s ago'), $time_diff_text);
    }
    return $time_diff_text;
}

说明：

• 自定义字段_actual_publish_time存储UTC时间戳，避免时区转换错误
• 通过get_the_date和human_time_diff过滤器，分别替换日期显示和「发布于X前」的文本
• 不修改默认post_date，保留原有归档、RSS等功能的逻辑

方案3：排查第三方干扰 #

如果上述方案无效，可能是主题或插件修改了定时发布的默认行为：

• 禁用所有插件，切换到Twenty系列默认主题，测试定时发布是否正常
• 逐个启用插件，定位导致post_date异常的插件
• 检查主题的save_post或future_to_publish钩子，是否有强制修改post_date的代码

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