如何为WooCommerce每个订单项添加元数据？及问题排查

你现在的核心问题有两个：

• 你的结账字段代码是把design值直接存在订单级别的postmeta（wp_postmeta），而不是订单项专属的wp_woocommerce_order_itemmeta表；
• 你尝试的woocommerce_checkout_create_order_line_item钩子代码，是从产品的postmeta里取design值，而不是用户在结账时输入的那个值，所以自然不会生效。

要把结账时输入的design值关联到每个订单项，需要分两步：先把结账字段的值保存到购物车项的临时会话数据中，再在创建订单项时把这个值写入订单项meta。

步骤1：修改结账字段逻辑，将值存入购物车会话 #

首先，我们需要在用户提交结账表单时，把design值绑定到每个购物车项的临时数据里，确保每个订单项都能拿到这个值：

// 显示结账自定义字段
add_action('woocommerce_after_order_notes', 'cw_custom_checkbox_fields');
function cw_custom_checkbox_fields( $checkout ) {
    woocommerce_form_field( 'design', array(
        'type'        => 'text',
        'label'       => '定制设计内容', // 可根据需求添加标签，优化用户体验
        'required'    => false, // 按需设置是否必填
    ), $checkout->get_value( 'design' ) );
}

// 将结账字段值保存到购物车项会话
add_action( 'woocommerce_checkout_update_order_review', 'cw_save_design_to_cart_session' );
function cw_save_design_to_cart_session( $posted_data ) {
    parse_str( $posted_data, $post_data );
    
    if ( isset( $post_data['design'] ) && ! empty( $post_data['design'] ) ) {
        foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
            // 将design值存入对应购物车项的临时数据
            WC()->cart->cart_contents[ $cart_item_key ]['design'] = sanitize_text_field( $post_data['design'] );
        }
    }
}

步骤2：创建订单项时，将会话值写入订单项meta #

现在我们可以在woocommerce_checkout_create_order_line_item钩子中，从购物车项的临时数据里取出design值，写入wp_woocommerce_order_itemmeta表：

// 将自定义数据保存到订单项meta
add_action( 'woocommerce_checkout_create_order_line_item', 'custom_checkout_create_order_line_item', 20, 4 );
function custom_checkout_create_order_line_item( $item, $cart_item_key, $values, $order ) {
    // 从购物车项的临时数据中取出design值
    if ( isset( $values['design'] ) && ! empty( $values['design'] ) ) {
        // 写入订单项meta：第一个参数是前台显示的标签，第二个是值
        $item->update_meta_data( '定制设计', $values['design'] );
        // 如果希望meta键在后台隐藏前台显示，可改为：$item->update_meta_data( '_design', $values['design'] ); （下划线开头会隐藏前台展示）
    }
}

额外场景：如果需要每个订单项有不同的定制值 #

如果你的需求是允许用户为每个商品单独设置design值（而非整个订单统一），那你需要在产品的「添加到购物车」表单里添加自定义字段，而不是在结账页加。比如在产品详情页添加输入框，将每个商品的定制值存入对应购物车项，再用上面的钩子写入订单项meta即可。

完成代码修改后，按以下流程测试：

1. 添加商品到购物车
2. 结账时输入design内容
3. 完成订单后，查看wp_woocommerce_order_itemmeta表，就能看到对应订单项的meta记录；同时在订单后台的订单项详情里，也能看到这个定制字段。

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