WordPress定时任务未更新自定义文章类型post_meta问题求助

环境与需求 #

• 自定义文章类型：place
• 元字段：highlight（DateTime类型，存储高亮功能的过期时间）
• 需求：当highlight存储的时间早于当前时间时，将该元字段更新为NULL

已使用代码 #

function jj_feaurecheck_cron_function( ) {

global $post;

$args = array( 
  'post_type'       => 'place',
  'posts_per_page'  => -1,
);

$listings = get_posts( $args );

foreach($listings as $post) : setup_postdata($post);

   $today = date( 'Ymd' );
   $expire = get_post_meta($post->ID, 'highlight', true);

   $today = new DateTime();
   $expire_date = new DateTime($expire);

   //convert dates to seconds for easier comparison
   $expire_secs = $expire_date->format('U');
   $today_secs  = $today->format('U');

   if ( $expire_secs < $today_secs ) :
      update_post_meta($post->ID, 'highlight', '' );
   endif;

endforeach;

}
add_action( 'jj_feaurecheck_cron', 'jj_feaurecheck_cron_function' );

function dg_cron_schedule_check_posts() {
   $timestamp = wp_next_scheduled( 'jj_feaurecheck_cron' );
   if ( $timestamp == false ) {
      wp_schedule_event( time(), 'every_minute', 'jj_feaurecheck_cron' );
   }
}
add_action( 'init', 'dg_cron_schedule_check_posts' );

排查情况 #

• 日期比较逻辑（$expire_secs < $today_secs）验证正常
• 通过WP Cron control确认定时任务已触发
• 异常：文章的post_meta未按预期更新

问题分析与修复方案 #

核心问题 #

你当前使用update_post_meta($post->ID, 'highlight', '' )，WordPress会将空字符串作为有效值存储，而非设置为NULL。此外，默认WordPress没有every_minute这个调度周期，之前的定时任务可能未正确按分钟执行。

修复后的代码 #

function jj_feaurecheck_cron_function() {
    // 只筛选包含highlight元字段的place类型文章，减少遍历量
    $args = array( 
        'post_type'      => 'place',
        'posts_per_page' => -1,
        'meta_query'     => array(
            array(
                'key'     => 'highlight',
                'compare' => 'EXISTS'
            )
        )
    );

    $listings = get_posts( $args );
    $today = new DateTime();

    foreach ( $listings as $listing ) {
        $expire_str = get_post_meta( $listing->ID, 'highlight', true );
        
        // 跳过空值或无效日期字符串
        if ( empty( $expire_str ) ) {
            continue;
        }

        try {
            $expire_date = new DateTime( $expire_str );
            
            // 直接用DateTime对象比较，无需转时间戳
            if ( $expire_date < $today ) {
                // 方案1：删除元字段，数据库中对应值为NULL
                delete_post_meta( $listing->ID, 'highlight' );
                
                // 方案2：强制设置为NULL（需保留字段键时使用）
                // update_post_meta( $listing->ID, 'highlight', null, $expire_str );
            }
        } catch ( Exception $e ) {
            // 记录无效日期错误，可选
            error_log( 'Invalid highlight date for post ID ' . $listing->ID . ': ' . $e->getMessage() );
            continue;
        }
    }
}
add_action( 'jj_feaurecheck_cron', 'jj_feaurecheck_cron_function' );

function dg_cron_schedule_check_posts() {
    $timestamp = wp_next_scheduled( 'jj_feaurecheck_cron' );
    if ( ! $timestamp ) {
        // 注册每分钟执行的自定义调度周期
        if ( ! wp_get_schedule( 'every_minute' ) ) {
            add_filter( 'cron_schedules', function( $schedules ) {
                $schedules['every_minute'] = array(
                    'interval' => 60,
                    'display'  => __( 'Every Minute' )
                );
                return $schedules;
            } );
        }
        wp_schedule_event( time(), 'every_minute', 'jj_feaurecheck_cron' );
    }
}
add_action( 'init', 'dg_cron_schedule_check_posts' );

关键修复点说明 #

1. 正确设置元字段为NULL：
   • 使用delete_post_meta会直接删除该元字段记录，数据库中对应值为NULL；
   • 若需保留highlight字段键，使用update_post_meta( $post_id, 'highlight', null, $old_value )，必须指定$prev_value参数才能将值更新为NULL。
2. 注册自定义调度周期：默认WordPress没有every_minute调度，需先注册才能让定时任务按分钟触发。
3. 优化查询与遍历：通过meta_query只获取包含highlight的文章，避免无意义遍历；用局部变量$listing代替全局$post，避免变量冲突。
4. 错误处理：捕获无效日期格式的异常，避免单个错误导致整个脚本中断。

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