WooCommerce自定义字段无法在订单详情及后台显示求排查

我仔细梳理了你的代码，发现几个核心问题导致自定义字段无法在订单详情和后台管理页面显示，下面逐一拆解问题并给出修复后的完整代码：

主要错误点 #

• 变量解析失效：多处用单引号包裹变量（比如name="$InputText1V"、$_REQUEST['$InputText1V']），PHP单引号内的变量不会被解析，导致无法正确获取表单值和存储数据。
• 购物车元数据键名混乱：使用带$的变量作为数组键，不仅容易出错，还不利于后续调用维护。
• 订单元数据保存逻辑错误：my_field_order_meta_handler函数参数不匹配、未正确挂载woocommerce_add_order_item_meta钩子；my_custom_checkout_field_update_order_meta中POST参数和元键名均存在变量解析问题。
• 购物车数据渲染逻辑错误：在render_meta_on_cart_and_checkout中循环整个购物车获取product_id，会导致所有商品都使用最后一个商品的字段名，应该直接使用传入的$cart_item数据。
• 后台显示函数未正确取值：my_custom_checkout_field_display_admin_order_meta中未定义$InputText1V变量，也未正确从订单元数据中读取值。

修复后的完整代码 #

// Add custom text field to product page
add_action('woocommerce_before_add_to_cart_button', 'my_custom_product_field');
function my_custom_product_field() {
    global $product;
    $product_id = $product->get_id();
    // Get field label from product meta
    $input_text_label = get_post_meta($product_id, 'InputText1', true);
    
    // Only show field if label exists
    if (!empty($input_text_label)) {
        echo '<div id="custom-input-text1">';
        echo '<label>' . esc_html($input_text_label) . '</label> <input type="text" name="custom_input_text1" required>';
        echo '</div>';
    }
}

// Save custom field value to cart item data
function save_custom_product_field_to_cart($cart_item_data, $product_id) {
    if (isset($_REQUEST['custom_input_text1']) && !empty($_REQUEST['custom_input_text1'])) {
        // Use a clear, fixed key for cart data
        $cart_item_data['custom_input_text1'] = sanitize_text_field($_REQUEST['custom_input_text1']);
        // Add unique key to ensure each add-to-cart creates a unique line item
        $cart_item_data['unique_key'] = md5(microtime() . rand());
    }
    return $cart_item_data;
}
add_action('woocommerce_add_cart_item_data', 'save_custom_product_field_to_cart', 10, 2);

// Render custom meta on cart and checkout pages
function render_custom_meta_on_cart_checkout($cart_data, $cart_item) {
    $custom_items = !empty($cart_data) ? $cart_data : [];
    
    if (isset($cart_item['custom_input_text1'])) {
        $product_id = $cart_item['product_id'];
        $input_text_label = get_post_meta($product_id, 'InputText1', true);
        $custom_items[] = [
            "name" => esc_html($input_text_label),
            "value" => esc_html($cart_item['custom_input_text1'])
        ];
    }
    return $custom_items;
}
add_filter('woocommerce_get_item_data', 'render_custom_meta_on_cart_checkout', 10, 2);

// Save custom field to order item meta (core step for order details display)
function save_custom_field_to_order_item($item_id, $cart_item, $order_item) {
    if (isset($cart_item['custom_input_text1'])) {
        $product_id = $cart_item['product_id'];
        $input_text_label = get_post_meta($product_id, 'InputText1', true);
        // Save with both readable label and fixed key for easy retrieval
        wc_add_order_item_meta($item_id, $input_text_label, $cart_item['custom_input_text1']);
        wc_add_order_item_meta($item_id, 'custom_input_text1', $cart_item['custom_input_text1']);
    }
}
add_action('woocommerce_add_order_item_meta', 'save_custom_field_to_order_item', 10, 3);

// Display custom field in admin order page
function display_custom_field_in_admin_order($order) {
    $order_id = method_exists($order, 'get_id') ? $order->get_id() : $order->id;
    
    // Loop through each order item to show its custom field
    foreach ($order->get_items() as $item) {
        $custom_value = wc_get_order_item_meta($item->get_id(), 'custom_input_text1', true);
        if (!empty($custom_value)) {
            $product_id = $item->get_product_id();
            $input_text_label = get_post_meta($product_id, 'InputText1', true);
            echo '<p><strong>' . esc_html($input_text_label) . ':</strong> ' . esc_html($custom_value) . '</p>';
        }
    }
}
add_action('woocommerce_admin_order_data_after_billing_address', 'display_custom_field_in_admin_order', 10, 1);

// Display custom field in customer's order details page
function display_custom_field_in_customer_order($item_id, $item) {
    $custom_value = wc_get_order_item_meta($item_id, 'custom_input_text1', true);
    if (!empty($custom_value)) {
        $product_id = $item->get_product_id();
        $input_text_label = get_post_meta($product_id, 'InputText1', true);
        echo '<p><strong>' . esc_html($input_text_label) . ':</strong> ' . esc_html($custom_value) . '</p>';
    }
}
add_action('woocommerce_order_item_meta_end', 'display_custom_field_in_customer_order', 10, 2);

关键修改说明 #

1. 统一固定键名：使用custom_input_text1作为全局键名，彻底避免变量解析错误，同时让代码更易维护。
2. 修复表单字段名：将输入框name改为custom_input_text1，确保能正确捕获用户输入。
3. 正确挂载订单元数据钩子：用woocommerce_add_order_item_meta钩子将自定义字段值保存到订单项元数据中，这是字段能在订单详情显示的核心操作。
4. 优化多商品订单显示：循环订单中的每个商品项，分别获取对应自定义字段值和标签，确保多商品订单能正确展示每个商品的自定义数据。
5. 补充客户订单页显示：新增woocommerce_order_item_meta_end钩子，让客户在自己的订单详情页也能看到自定义字段内容。

内容的提问来源于stack exchange，提问作者Manuel Orozco Jimenez