寻求WooCommerce程序化创建订单的正确配送数据钩子

针对你遇到的脚本/插件创建订单时无法获取有效配送数据的问题，以下几个钩子能精准适配需求，避免多次触发或数据缺失的情况：

1. woocommerce_order_save_post（优先推荐） #

这是WooCommerce官方提供的订单专属保存钩子，仅在shop_order类型的帖子保存时触发，且直接传入完整的$order对象，确保配送数据已完全写入。

add_action('woocommerce_order_save_post', 'fix_order_shipping_fee', 10, 2);

function fix_order_shipping_fee($order_id, $order) {
    // 跳过已修复的订单，避免循环触发
    if ($order->get_meta('_shipping_fee_fixed')) {
        return;
    }

    // 检查是否存在配送方式且配送费为0
    if ($order->has_shipping_method() && $order->get_shipping_total() === 0) {
        // 自定义配送费金额，可根据实际逻辑调整
        $shipping_cost = 12.99;
        $order->set_shipping_total($shipping_cost);
        $order->calculate_totals();
        
        // 添加标记防止重复处理
        $order->update_meta_data('_shipping_fee_fixed', '1');
        $order->save();
    }
}

2. woocommerce_after_save_order_item（针对配送订单项） #

如果配送数据是通过订单配送项写入的，这个钩子会在配送订单项保存后触发，能确保获取到完整的配送明细。

add_action('woocommerce_after_save_order_item', 'fix_shipping_item_total', 10, 3);

function fix_shipping_item_total($item_id, $item, $order_id) {
    // 仅处理配送类型的订单项
    if ($item->get_type() !== 'shipping') {
        return;
    }

    $order = wc_get_order($order_id);
    // 检查配送费是否为0
    if ($item->get_total() === 0) {
        $item->set_total(12.99);
        $item->save();
        
        // 重新计算订单总额
        $order->calculate_totals();
        $order->save();
    }
}

3. wp_insert_post（带严格条件过滤） #

若上述WooCommerce钩子不适用，可使用WordPress原生钩子，但需添加严格条件过滤掉无效触发：

add_action('wp_insert_post', 'handle_order_shipping_data', 10, 3);

function handle_order_shipping_data($post_id, $post, $update) {
    // 仅处理订单类型、且为更新操作（创建时可能还无配送数据）
    if ($post->post_type !== 'shop_order' || !$update) {
        return;
    }

    $order = wc_get_order($post_id);
    // 检查配送数据是否存在且配送费为0
    if ($order && $order->get_shipping_method() && $order->get_shipping_total() === 0) {
        $order->set_shipping_total(12.99);
        $order->calculate_totals();
        $order->save();
    }
}

关键注意事项 #

• 所有钩子中添加自定义元数据标记（如_shipping_fee_fixed），避免因$order->save()导致的循环触发问题。
• 优先选择WooCommerce专属钩子，它们更贴合订单生命周期，兼容性更强，能减少不必要的判断逻辑。

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