启用HPOS的WooCommerce自动删除旧订单代码报错求助

问题背景 #

需要配置自动清理3个月以上的已完成订单，启用High Performance Orders Storage（HPOS）后原有代码失效，调试时每个订单ID都弹出“Error deleting order ID”提示，原尝试代码如下：

add_action( 'admin_footer', 'auto_trash_old_completed_orders_345erhwe546' );
function auto_trash_old_completed_orders_345erhwe546() {
    global $nm_theme_options;

    if ( isset( $nm_theme_options['delete_all_woo_orders_older_then_3_months'] ) && $nm_theme_options['delete_all_woo_orders_older_then_3_months'] == 1 ) {
        // Theme option is set to delete old orders

        $completed_order_ids = wc_get_orders( array(
            'limit'         => 100, // By batch of 100 orders
            'status'        => 'completed', 
            'return'        => 'ids',
            'date_created'  => '<' . date( 'Y-m-d', strtotime( '-3 months' ) ),
        ) );

        if ( count( $completed_order_ids ) > 0 ) {
            // Orders found, proceed to delete

            foreach ( $completed_order_ids as $completed_order_id ) {
                $trashed = wp_trash_post( $completed_order_id );
                $deleted = wp_delete_post( $completed_order_id, true );

                // DEBUG
                if ( ! $trashed || ! $deleted ) {
                    echo '<script>alert("Error deleting order ID: ' . $completed_order_id . '");</script>';
                }
                
            }
        }
        
        // DEBUG
        echo '<script>alert("Orders deleted: ' . count( $completed_order_ids ) . '");</script>';
        
    } else {
        
        // DEBUG
        echo '<script>alert("Theme option not set to delete old orders.");</script>';
        
    }
}

问题原因 #

1. HPOS存储机制改变：启用HPOS后，订单不再以WordPress文章（post）的形式存储，wp_trash_post()和wp_delete_post()这类针对文章的函数无法识别HPOS订单，导致删除失败。
2. 执行时机不合理：挂载到admin_footer会在后台每一次页面加载时执行，不仅影响性能，还可能触发重复操作。

修复方案 #

使用WooCommerce官方提供的订单对象方法处理删除操作，并改用定时任务执行清理逻辑，代码如下：

// 注册每日定时任务
add_action('wp', 'setup_old_orders_cleanup_cron');
function setup_old_orders_cleanup_cron() {
    if (!wp_next_scheduled('auto_clean_old_completed_orders')) {
        wp_schedule_event(time(), 'daily', 'auto_clean_old_completed_orders');
    }
}

// 核心清理逻辑
add_action('auto_clean_old_completed_orders', 'auto_trash_old_completed_orders');
function auto_trash_old_completed_orders() {
    global $nm_theme_options;

    // 检查主题开关是否开启
    if (!isset($nm_theme_options['delete_all_woo_orders_older_then_3_months']) || $nm_theme_options['delete_all_woo_orders_older_then_3_months'] !== 1) {
        return;
    }

    // 查询符合条件的已完成订单
    $completed_orders = wc_get_orders(array(
        'limit'         => 100, // 分批处理，避免一次性处理过多订单
        'status'        => 'completed',
        'return'        => 'objects', // 返回订单对象，兼容HPOS
        'date_created'  => '<' . date('Y-m-d', strtotime('-3 months')),
        'type'          => 'shop_order',
    ));

    if (empty($completed_orders)) {
        return;
    }

    foreach ($completed_orders as $order) {
        try {
            // HPOS兼容的删除方法：true=永久删除，false=移至回收站
            $order->delete(true);
        } catch (Exception $e) {
            // 记录错误日志，便于排查
            error_log('删除订单ID ' . $order->get_id() . ' 失败: ' . $e->getMessage());
        }
    }
}

// 如需停用清理功能，取消下方注释以移除定时任务
// add_action('wp', 'remove_old_orders_cleanup_cron');
// function remove_old_orders_cleanup_cron() {
//     wp_clear_scheduled_hook('auto_clean_old_completed_orders');
// }

关键改进点 #

• HPOS兼容：使用订单对象的delete()方法，这是WooCommerce官方推荐的HPOS兼容操作方式。
• 性能优化：改用每日定时任务执行，避免后台页面加载时重复运行。
• 错误处理：添加异常捕获并记录日志，方便后续排查问题。
• 逻辑简化：直接获取订单对象，无需手动处理ID对应的资源验证。

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