WooCommerce下单时如何正确获取父级shop_order订单触发钩子

需要实现WooCommerce新订单创建、订单更新两个场景下触发自定义插件逻辑，要求逻辑仅在主订单（post type为shop_order）节点触发，避免被附属的wc_booking、wcdp_payment等子级记录误触发。
当前已实现的订单更新逻辑运行正常，但使用woocommerce_thankyou钩子处理新订单场景时，钩子触发节点落在最后一条wcdp_payment记录生成时，拿不到完整的主订单信息。

现有代码如下：

add_action('save_post_shop_order', 'printout', 10, 3);

function printout($post_ID, $post, $update)
{

    $posttype = get_post_type($post_id);
    write_to_log('Post Type:' . $posttype);

    if (!is_admin()){
        return;
    }

    if($update && get_post_type($post_id) === "shop_order"){
        $msg = $post_ID;
        $order = get_woocommerce_order($msg);
        mainplugin($msg, $order);
    }

}


add_action('woocommerce_thankyou', 'neworder_created', 10, 2);


function neworder_created($order_id){
    $order = get_woocommerce_order($order_id);

    mainplugin($order_id, $order);
}

订单创建时数据库生成记录的顺序为：

• wc_booking（子级）
• shop_order（父级）
• wcdp_payment（子级）
• wcdp_payment（子级）

1. 不要用woocommerce_thankyou处理核心订单逻辑 #

woocommerce_thankyou是前端支付成功跳转感谢页时触发的面向前端的钩子，本身不绑定主订单的数据库写入节点，只要支付相关回调触发、跳转感谢页就会执行，很容易被支付插件生成的附属记录干扰，完全不适合做依赖主订单完整数据的后端逻辑触发。

2. 统一用save_post_shop_order覆盖新订单+订单更新场景 #

你现在已经在使用的save_post_shop_order是WordPress原生针对shop_order这个post type的专属保存钩子，只会在主订单shop_order写入/更新数据库时触发，根本不会被wc_booking、wcdp_payment这些其他post type的记录触发，天然满足「仅在shop_order节点运行」的要求，不需要额外加post type校验。
你当前的代码只判断了$update === true的更新场景，只要补上$update === false（代表post首次插入，即新订单创建）的分支，就可以完全覆盖两个场景，不需要额外挂载其他钩子。

修正后的完整代码如下：

add_action('save_post_shop_order', 'trigger_main_plugin_logic', 10, 3);
function trigger_main_plugin_logic($post_ID, $post, $update){
    // 排除自动保存、修订版本的无效触发
    if (wp_is_post_autosave($post_ID) || wp_is_post_revision($post_ID)){
        return;
    }

    // 钩子本身仅针对shop_order，不需要重复校验post type，直接获取订单实例即可
    $order = wc_get_order($post_ID);
    if(!$order instanceof WC_Order){
        return;
    }

    // 按需加订单状态过滤，避免草稿、临时订单触发逻辑
    $allowed_status = ['pending', 'processing', 'completed'];
    if(!in_array($order->get_status(), $allowed_status, true)){
        return;
    }

    // 加幂等标记，保证同一个订单逻辑只执行一次，避免多次save_post导致重复调用
    $already_run = get_post_meta($post_ID, '_custom_plugin_logic_run', true);
    if($already_run){
        return;
    }

    mainplugin($post_ID, $order);
    update_post_meta($post_ID, '_custom_plugin_logic_run', 1);
}

// 原有woocommerce_thankyou相关的新订单处理逻辑可以直接删除

3. 原有代码的问题修正 #

• 变量大小写bug：函数参数传入的是$post_ID（大写ID），函数内调用时写的是$post_id（小写id），PHP变量区分大小写，这个问题会导致你拿不到正确的post类型数据，需要统一变量名。
• 拦截逻辑bug：原代码中if (!is_admin()) return;的判断会拦截前端用户正常下单时的钩子触发（前端请求不属于admin后台上下文），这也是你之前新订单场景无法复用这个钩子的核心原因之一。如果不需要限制逻辑仅在后台手动编辑订单时运行，就删掉这个判断，靠上面提到的自动保存校验、订单状态校验、幂等标记过滤无效执行即可。
• 重复触发问题：save_post_shop_order在订单生命周期内会因为改状态、加备注、支付回调等操作触发多次，必须加幂等标记，避免重复调用mainplugin导致重复推送、重复处理的问题。

如果确实需要在前端支付成功跳转节点加额外逻辑，可以保留woocommerce_thankyou钩子，但要先通过传入的$order_id做校验：get_post_type($order_id) === 'shop_order'，同时也要加重复触发判断，因为用户刷新感谢页会重复触发这个钩子。

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