WooCommerce结账页自定义字段验证异常问题求助

问题现象 #

在WooCommerce结账页添加了两个自定义必填字段（活动场地选择、展位号输入），字段正常显示，但填写内容提交订单时，系统仍提示需填写这些字段，无法识别已输入的内容。

代码错误分析 #

1. 字段位置错误：使用woocommerce_before_checkout_form钩子渲染字段，该钩子位于结账表单外部，导致字段数据无法随表单提交到后台。
2. 用户元数据获取错误：未初始化$current_user变量就直接调用其属性，无法读取用户保存的历史数据。
3. 验证逻辑错误：两个字段的验证逻辑嵌套，仅当活动场地字段为空时才检查展位号，导致展位号字段的验证不独立。
4. 元数据键名错误：订单完成页读取元数据时使用了错误的键名（缺少下划线、大小写错误、多余空格），无法正确显示数据。
5. 函数名不匹配：邮件通知的钩子绑定函数名与实际定义的函数名不一致，导致邮件中无法显示自定义字段。

修正后的完整代码 #

// 在结账表单内部添加自定义字段
add_action('woocommerce_checkout_before_customer_details', 'custom_add_custom_checkout_fields');

function custom_add_custom_checkout_fields($checkout)
{
    echo '<h3>活动信息</h3>';

    // 获取当前用户对象
    $current_user = wp_get_current_user();

    // 读取用户保存的元数据
    $saved_event_venue = get_user_meta($current_user->ID, 'event_venue', true);
    $saved_hall_stand_number = get_user_meta($current_user->ID, 'hall_stand_number', true);

    woocommerce_form_field('event_venue', array(
        'type' => 'select',
        'class' => array('form-row-wide'),
        'label' => '活动/展会 & 场地',
        'options' => array(
            '' => '请选择',
            'event1' => '活动1场地',
            'event2' => '活动2场地',
            'event3' => '活动3场地'
            // 可添加更多选项
        ),
        'required' => true,
        'default' => $saved_event_venue,
    ), $checkout->get_value('event_venue'));

    woocommerce_form_field('hall_stand_number', array(
        'type' => 'text',
        'class' => array('form-row-wide'),
        'label' => '展厅 & 展位号',
        'placeholder' => '请输入展厅和展位号',
        'required' => true,
        'default' => $saved_hall_stand_number,
    ), $checkout->get_value('hall_stand_number'));
}

// 独立验证每个自定义字段
add_action('woocommerce_checkout_process', 'custom_validate_checkout_fields');

function custom_validate_checkout_fields()
{
    if (empty($_POST['event_venue'])) {
        wc_add_notice('请选择活动/展会及场地。', 'error');
    }

    if (empty($_POST['hall_stand_number'])) {
        wc_add_notice('请输入展厅及展位号。', 'error');
    }
}

// 保存自定义字段到订单元数据，同时同步到用户元数据
add_action('woocommerce_checkout_update_order_meta', 'custom_save_checkout_fields');

function custom_save_checkout_fields($order_id)
{
    if (!empty($_POST['event_venue'])) {
        update_post_meta($order_id, '_event_venue', esc_attr($_POST['event_venue']));
        $user_id = get_current_user_id();
        if ($user_id) {
            update_user_meta($user_id, 'event_venue', esc_attr($_POST['event_venue']));
        }
    }

    if (!empty($_POST['hall_stand_number'])) {
        update_post_meta($order_id, '_hall_stand_number', esc_attr($_POST['hall_stand_number']));
        $user_id = get_current_user_id();
        if ($user_id) {
            update_user_meta($user_id, 'hall_stand_number', esc_attr($_POST['hall_stand_number']));
        }
    }
}

// 在订单完成页面显示自定义字段
add_action('woocommerce_thankyou', 'custom_new_checkout_field_thankyou');

function custom_new_checkout_field_thankyou($order_id)
{
    $event_venue = get_post_meta($order_id, '_event_venue', true);
    if ($event_venue) {
        echo '<p><strong>活动/展会 & 场地:</strong> ' . esc_html($event_venue) . '</p>';
    }

    $hall_stand = get_post_meta($order_id, '_hall_stand_number', true);
    if ($hall_stand) {
        echo '<p><strong>展厅 - 展位号:</strong> ' . esc_html($hall_stand) . '</p>';
    }
}

// 在后台订单详情页显示自定义字段
add_action('woocommerce_admin_order_data_after_billing_address', 'custom_new_checkout_field_order');

function custom_new_checkout_field_order($order)
{
    $event_venue = get_post_meta($order->get_id(), '_event_venue', true);
    if ($event_venue) {
        echo '<p><strong>活动/展会 - 场地:</strong> ' . esc_html($event_venue) . '</p>';
    }

    $hall_stand = get_post_meta($order->get_id(), '_hall_stand_number', true);
    if ($hall_stand) {
        echo '<p><strong>展厅 - 展位号:</strong> ' . esc_html($hall_stand) . '</p>';
    }
}

// 在订单邮件中显示自定义字段
add_action('woocommerce_email_after_order_table', 'custom_new_checkout_field_emails', 20, 4);

function custom_new_checkout_field_emails($order, $sent_to_admin, $plain_text, $email ) {
    $event_venue = get_post_meta($order->get_id(), '_event_venue', true);
    if ($event_venue) {
        echo '<p><strong>活动/展会 - 场地:</strong> ' . esc_html($event_venue) . '</p>';
    }

    $hall_stand = get_post_meta($order->get_id(), '_hall_stand_number', true);
    if ($hall_stand) {
        echo '<p><strong>展厅 - 展位号:</strong> ' . esc_html($hall_stand) . '</p>';
    }
}

关键修正说明 #

• 更换字段渲染钩子为woocommerce_checkout_before_customer_details，确保字段处于结账表单内部，数据能被正常提交。
• 修复用户元数据读取逻辑，通过wp_get_current_user()和get_user_meta()正确获取用户历史数据。
• 拆分验证逻辑，每个字段独立判断，保证任一字段为空时都能触发对应错误提示。
• 统一元数据键名的拼写、格式，确保数据读写一致。
• 匹配邮件钩子的函数名，移除多余判断条件，保证邮件中正常显示字段内容。
• 新增字段内容同步到用户元数据的逻辑，方便用户下次购买时自动填充。

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