启用HPOS后WooCommerce订单元数据无法获取，如何修改代码？

HPOS（高性能订单存储）启用后，订单不再以WordPress文章（Post）类型存储，原有的get_post_meta()这类针对post表的元数据操作函数自然无法获取到HPOS订单的元数据，必须改用WooCommerce官方提供的订单对象方法来处理。

代码修改示例 #

原代码（仅兼容传统订单存储）：

// 获取订单ID
$order_id = $request['order_id'];
// 获取追踪号元数据
$tracking_number = get_post_meta($order_id, '_tracking_number', true);
// 其他元数据获取同理
$shipping_note = get_post_meta($order_id, '_shipping_note', true);

修改后代码（兼容HPOS与传统存储）：

// 获取订单ID
$order_id = $request['order_id'];
// 获取HPOS兼容的订单对象
$order = wc_get_order($order_id);

// 通过订单对象获取元数据
$tracking_number = $order->get_meta('_tracking_number', true);
$shipping_note = $order->get_meta('_shipping_note', true);

// 如果需要更新元数据，也用订单对象的方法
// $order->update_meta_data('_tracking_number', 'NEW-TRACKING-123');
// $order->save();

关键注意事项 #

• 所有涉及订单元数据的读写操作，都要替换为订单对象的get_meta()/update_meta_data()方法，替代原有的get_post_meta()/update_post_meta()
• wc_get_order()是WooCommerce提供的兼容函数，无论HPOS是否启用，都能正确获取订单对象，无需额外判断存储模式
• 如果邮件逻辑依赖订单的其他数据（如收货地址、商品信息），同样建议通过订单对象的专属方法获取（比如$order->get_shipping_address_1()），而非直接操作post数据

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