WooCommerce如何通过URL触发全量订单更新并执行save_post_shop_order动作

问题原因 #

你现有代码不生效的核心原因是WooCommerce 3.0+版本使用独立的自定义数据表存储订单数据，WC_Order::save() 方法仅会更新订单自定义表数据，不会触发WordPress原生的save_post_shop_order钩子。

修正代码 #

add_action('wp_head', 'update_orders_by_url');
function update_orders_by_url() {
    // 权限校验，仅管理员可触发，避免安全风险
    if( !current_user_can('manage_woocommerce') || !isset( $_GET['update_woo_orders'] ) ) {
        return;
    }

    $query = new WC_Order_Query( array(
        'limit' => -1,
        // 可按需调整需要处理的订单状态，减少性能消耗
        'status' => array('wc-completed', 'wc-processing', 'wc-on-hold')
    ));
    
    $orders = $query->get_orders();
    $processed_count = 0;

    foreach($orders as $order){
        $order_id = $order->get_id();
        // 执行订单原生保存逻辑
        $order->save();
        
        // 手动触发save_post_shop_order钩子，参数与原生触发一致
        $post = get_post($order_id);
        do_action('save_post_shop_order', $order_id, $post, true);
        
        $processed_count++;
    }

    echo '处理完成，共触发' . $processed_count . '个订单的save_post_shop_order动作';
    exit;
}

注意事项 #

• 触发时访问站点任意前台页面，URL末尾添加?update_woo_orders参数即可执行
• 建议只在站点低峰期执行，订单量较大时可能会出现超时，可按需调整limit参数分批处理
• 如果你挂载的自定义函数依赖save_post通用钩子而非save_post_shop_order钩子，可在手动触发部分额外添加do_action('save_post', $order_id, $post, true);

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