WooCommerce woocommerce_checkout_create_order钩子无法触发问题求助

问题描述 #

在WordPress中开发WooCommerce功能时，绑定到woocommerce_checkout_create_order钩子的自定义函数无法触发。期望通过error_log记录日志，但错误日志中无相关条目。

使用的代码如下：

add_action('woocommerce_checkout_create_order', 'custom_checkout_field_update_order_meta', 1, 2);

function custom_checkout_field_update_order_meta($order, $data) {
    error_log('test',print_r($order,true));

    if (WC()->session->__isset('custom_form_data')) {
        $custom_data = WC()->session->get('custom_form_data');

        $order->update_meta_data('_custom_form_data', $custom_data);

        $meta_data = $order->get_meta('_custom_form_data');

        WC()->session->__unset('custom_form_data');
    }
}

补充信息 #

• 使用最新版本的WooCommerce；
• 代码中其他error_log调用正常工作；
• 将同一函数绑定到wp_footer钩子时功能正常；
• 已排查插件和主题冲突，问题仍存在。

排查与解决方案 #

1. 修正error_log语法错误 #

你的error_log调用参数顺序错误，导致日志无法正常输出，这可能是误以为钩子未触发的核心原因之一。正确写法如下：

// 方式1：拼接字符串输出
error_log('test ' . print_r($order, true));
// 方式2：将数据作为数组输出
error_log(print_r(['hook_triggered' => true, 'order_data' => $order], true));

2. 确认钩子触发场景 #

woocommerce_checkout_create_order仅在前台用户完成常规结账流程创建订单时触发，以下场景不会触发该钩子：

• 后台手动创建订单；
• 通过REST API创建订单；
• 第三方插件（订阅、预订类）创建订单；
• 自定义结账流程跳过了标准订单创建步骤。
  请确保你是在前台正常结账的场景下测试。

3. 调整钩子优先级 #

尝试提高钩子优先级（比如改为100），避免被其他主题/插件的同钩子函数覆盖：

add_action('woocommerce_checkout_create_order', 'custom_checkout_field_update_order_meta', 100, 2);

4. 验证WC核心对象可用性 #

在函数开头添加基础验证，确认WC对象和会话是否正常初始化：

function custom_checkout_field_update_order_meta($order, $data) {
    // 验证WC函数是否可用
    if (!function_exists('WC')) {
        error_log('WC core function not loaded');
        return;
    }
    // 验证WC会话是否初始化
    if (empty(WC()->session)) {
        error_log('WC session not initialized');
        return;
    }
    // 后续日志与业务逻辑
    error_log('test ' . print_r($order, true));
    // ...
}

5. 尝试替代钩子 #

如果上述方法无效，可以使用订单创建阶段的替代钩子：

• woocommerce_new_order：订单创建完成后触发，参数为$order_id
• woocommerce_checkout_process：结账验证阶段触发，适合提前处理会话数据

示例（使用woocommerce_new_order）：

add_action('woocommerce_new_order', 'custom_update_order_meta_after_create', 10, 1);
function custom_update_order_meta_after_create($order_id) {
    $order = wc_get_order($order_id);
    error_log('test ' . print_r($order, true));
    
    if (WC()->session->__isset('custom_form_data')) {
        $custom_data = WC()->session->get('custom_form_data');
        $order->update_meta_data('_custom_form_data', $custom_data);
        $order->save(); // 此钩子下需要手动保存订单数据
        WC()->session->__unset('custom_form_data');
    }
}

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