WooCommerce中判断订单及订单项元数据是否存在的技术咨询

一、HPOS 订单元数据（wp_wc_orders_meta）存在性判断 #

对于 HPOS 模式下的订单，优先使用 WooCommerce 官方提供的 WC_Order 对象方法判断元数据是否存在，避免直接操作数据库：

// 获取兼容 HPOS 的 WC_Order 对象
$order = wc_get_order( $order_id );

if ( $order && ! $order->meta_exists( 'your_meta_key' ) ) {
    $my_metadata_exists = 0;
}

若需脱离订单对象直接查询数据库，可借助 WordPress 的 $wpdb 类：

global $wpdb;
$meta_exists = $wpdb->get_var(
    $wpdb->prepare(
        "SELECT EXISTS(SELECT 1 FROM {$wpdb->prefix}wc_orders_meta WHERE order_id = %d AND meta_key = %s)",
        $order_id,
        'your_meta_key'
    )
);

$my_metadata_exists = $meta_exists ? 1 : 0;

二、订单项元数据（wp_woocommerce_order_itemmeta）存在性判断 #

针对订单项的元数据，需先获取对应订单项对象再进行判断：

// 已知订单项 ID $item_id 的情况下
$order_item = wc_get_order_item( $item_id );

if ( $order_item && ! $order_item->meta_exists( 'your_item_meta_key' ) ) {
    $item_metadata_exists = 0;
}

直接数据库查询的写法：

global $wpdb;
$item_meta_exists = $wpdb->get_var(
    $wpdb->prepare(
        "SELECT EXISTS(SELECT 1 FROM {$wpdb->prefix}woocommerce_order_itemmeta WHERE order_item_id = %d AND meta_key = %s)",
        $item_id,
        'your_item_meta_key'
    )
);

$item_metadata_exists = $item_meta_exists ? 1 : 0;

三、$order->get_meta() 的性能与内存问题 #

1. 速度对比：
   • 若订单对象已加载（元数据已缓存至内存），调用 get_meta() 获取数组与调用 meta_exists() 判断存在性的速度几乎无差异，均为读取内存缓存操作。
   • 若为首次查询，meta_exists() 执行的是 EXISTS 型轻量查询（仅返回布尔值），get_meta() 则查询并返回具体元值。两者均为单条数据库查询，性能差异极小，可忽略不计。
2. 内存占用：
   4-5个元素的数组序列化后数据量极小（通常仅几十字节），对 PHP 内存的占用完全无需担忧。WooCommerce 本身会处理元数据的缓存与内存管理，这种规模的数据不会造成任何内存压力。

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