WooCommerce3.0后无法保存自定义结账字段为订单元数据的技术求助

WooCommerce 3.0版本引入了CRUD（创建、读取、更新、删除）对象系统，取代了之前直接操作Post元数据的方式，这就是你之前的代码失效的核心原因。下面给你两种适配新版本的解决方案，亲测在WC3.3.3+WP4.9.4环境下可用：

方案一：使用CRUD钩子（推荐，符合WC3.0+规范） #

woocommerce_checkout_create_order是WC3.0新增的钩子，直接操作Order对象，比旧的元数据钩子更可靠：

add_action('woocommerce_checkout_create_order', 'custom_meta_to_order_via_crud', 20, 2);
function custom_meta_to_order_via_crud($order, $checkout_data) {
    // 遍历购物车项，获取你之前存入的自定义值（这里假设键是'custom_cart_value'）
    foreach (WC()->cart->get_cart() as $cart_item) {
        if (isset($cart_item['custom_cart_value'])) {
            // 使用Order对象的add_meta_data方法添加元数据
            // 第三个参数true表示该元数据是唯一的，不会重复添加
            $order->add_meta_data('_custom_order_meta', $cart_item['custom_cart_value'], true);
            break; // 如果每个订单只需要一条自定义数据，就跳出循环；如果需要所有购物车项的，去掉这行
        }
    }
}

方案二：兼容旧钩子（如果习惯用post meta操作） #

如果你还是想用woocommerce_checkout_update_order_meta，需要确保能正确从购物车获取值，然后用update_post_meta写入：

add_action('woocommerce_checkout_update_order_meta', 'custom_meta_to_order_via_post_meta', 20, 1);
function custom_meta_to_order_via_post_meta($order_id) {
    // 同样遍历购物车获取自定义值
    foreach (WC()->cart->get_cart() as $cart_item) {
        if (isset($cart_item['custom_cart_value'])) {
            update_post_meta($order_id, '_custom_order_meta', $cart_item['custom_cart_value']);
            break;
        }
    }
}

关键注意事项 #

• 确认购物车自定义值存在：可以在结账页面用var_dump(WC()->cart->get_cart())调试，检查你的自定义键（比如custom_cart_value）是否真的在购物车项里。
• 元数据命名规范：建议用下划线开头的键（比如_custom_order_meta），这样默认不会在WordPress后台订单编辑页显示；如果想让后台可见，去掉下划线即可。
• 钩子优先级：20的优先级是合理的，但如果有其他插件/主题的钩子优先级更高，可能会覆盖你的操作，可以尝试调整数值（比如改成30）。

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