WooCommerce自定义结账字段保存与后台显示：多数量字段仅存单值

这个问题的核心原因很直白：你生成的多个相同字段共用了同一个name属性，表单提交时后面的字段值会直接覆盖前面的，最终只会保留最后一个输入的值。解决的关键就是给每个重复字段设置唯一的name标识，再在订单保存环节批量处理这些字段值。

第一步：修改字段生成代码，添加唯一命名 #

遍历商品数量生成字段时，要给每个字段的name加上专属区分符，比如结合购物车项的唯一key和数量索引，或者全局递增的序号。这里推荐用数组形式的name，后续处理起来更方便：

$index = 0;
foreach(WC()->cart->get_cart() as $cart_item_key => $cart_item){
    // 遍历当前商品的每个数量单元
    for($i = 1; $i <= $cart_item['quantity']; $i++){
        $index++;
        // 用数组形式的name，自动分组购物车项和对应数量的字段
        woocommerce_form_field(
            "custom_field[$cart_item_key][$i]",
            array(
                'type'        => 'text',
                'label'       => __('自定义字段 #'.$index, 'your-text-domain'),
                'required'    => true,
                'class'       => array('form-row-wide'),
            ),
            isset($_POST["custom_field[$cart_item_key][$i]"]) ? wc_clean($_POST["custom_field[$cart_item_key][$i]"]) : ''
        );
    }
}

数组形式的name会让提交后的POST数据自动整理成二维结构，不用自己拆分字符串，处理起来更省心。

第二步：批量保存字段值到订单元数据 #

接下来用WooCommerce的钩子捕获表单提交的数据，把所有字段值保存到订单的元数据里。这里用woocommerce_checkout_update_order_meta钩子举例：

add_action('woocommerce_checkout_update_order_meta', 'save_multiple_custom_checkout_fields', 10, 1);
function save_multiple_custom_checkout_fields($order_id){
    if(isset($_POST['custom_field']) && is_array($_POST['custom_field'])){
        $all_field_data = array();
        // 遍历所有提交的字段值
        foreach($_POST['custom_field'] as $cart_item_key => item_fields){
            foreach(item_fields as $quantity_index => $field_value){
                if(!empty($field_value)){
                    // 方式1：把所有字段整理成数组存到一个元数据
                    $all_field_data[] = array(
                        'item_name' => WC()->cart->get_cart_item($cart_item_key)['data']->get_name(),
                        'index'     => $quantity_index,
                        'value'     => wc_clean($field_value)
                    );
                    // 方式2：给每个字段单独创建元数据（用唯一key）
                    update_post_meta($order_id, 'custom_field_'.$cart_item_key.'_'.$quantity_index, wc_clean($field_value));
                }
            }
        }
        // 保存整理后的数组元数据
        if(!empty($all_field_data)){
            update_post_meta($order_id, 'all_custom_checkout_fields', $all_field_data);
        }
    }
}

两种保存方式可以二选一：单独保存适合需要单独调用某个字段的场景，数组保存适合统一展示所有字段的场景。

第三步：在订单页面和邮件中展示字段值 #

最后要把保存的字段值展示给用户和管理员，比如订单详情页、用户账户的订单列表，还有订单邮件里。这里以订单详情页为例：

add_action('woocommerce_order_details_after_order_table', 'display_multiple_custom_fields_in_order', 10, 1);
function display_multiple_custom_fields_in_order($order){
    $all_fields = get_post_meta($order->get_id(), 'all_custom_checkout_fields', true);
    if(!empty($all_fields)){
        echo '<h2>'.__('自定义字段信息', 'your-text-domain').'</h2>';
        echo '<ul style="list-style-type: disc; margin-left: 20px;">';
        foreach($all_fields as $field){
            echo '<li>'.$field['item_name'].' 第'.$field['index'].'份：'.$field['value'].'</li>';
        }
        echo '</ul>';
    }
}

如果是用单独保存的元数据，就遍历订单里的商品项，匹配对应的字段key去获取值即可。要添加到邮件里的话，用woocommerce_email_order_meta_fields钩子，逻辑和上面类似。

关键要点回顾 #

• 动态生成的表单字段必须有唯一的name属性，这是避免值被覆盖的核心
• 数组形式的name能大幅降低批量处理字段的复杂度
• 保存订单元数据时，根据后续使用场景选择合适的保存方式
• 最后一定要在前端展示保存的值，不然用户和管理员看不到数据

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