如何通过产品ID查询WooCommerce订单并实现分页？

你遇到的核心问题是内存层面过滤订单（先拿订单再查产品）会破坏原有的分页逻辑——因为limit参数是先取出所有符合基础条件的订单，再在内存里筛选包含指定产品的订单，导致实际返回的订单数可能远小于设定的limit，分页自然失效。下面提供三种靠谱的解决方案，按推荐程度排序：

方法1：扩展WC_Order_Query支持产品ID查询（推荐） #

这种方法完全贴合WooCommerce的查询体系，能直接复用你已有的WC_Order_Query代码，同时保证分页在数据库层面生效。原理是通过过滤器关联订单商品表，直接在SQL查询阶段过滤包含指定产品的订单。

实现代码： #

/**
 * 扩展WC_Order_Query，支持通过product_id参数筛选包含指定产品的订单
 * @param array $query WP_Query的参数数组
 * @param array $query_vars WC_Order_Query传入的查询变量
 * @return array 修改后的查询参数
 */
function handle_product_id_query_var( $query, $query_vars ) {
    if ( ! empty( $query_vars['product_id'] ) ) {
        global $wpdb;
        
        // 关联订单商品表和订单商品元数据表
        $query['join'] .= "
            INNER JOIN {$wpdb->prefix}woocommerce_order_items AS order_items
                ON {$wpdb->posts}.ID = order_items.order_id
            INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS order_itemmeta
                ON order_items.order_item_id = order_itemmeta.order_item_id
        ";
        
        // 添加产品ID的过滤条件
        $query['where'] .= $wpdb->prepare(
            " AND order_itemmeta.meta_key = '_product_id' AND order_itemmeta.meta_value = %d ",
            absint( $query_vars['product_id'] )
        );
        
        // 去重，避免同一订单包含多个相同产品时重复返回
        $query['distinct'] = true;
    }
    return $query;
}
add_filter( 'woocommerce_order_data_store_cpt_get_orders_query', 'handle_product_id_query_var', 10, 2 );

使用方式： #

现在你可以直接在WC_Order_Query里传入product_id参数，分页逻辑完全正常：

$query = new WC_Order_Query( array(
    'paginate' => true,
    'limit' => 2,
    'orderby' => 'date',
    'order' => 'DESC',
    'product_id' => 123, // 替换成你要查询的产品ID
) );
$activity = $query->get_orders();

// 正常处理分页
echo '总订单数：' . $activity->total;
echo '总页数：' . $activity->max_num_pages;

方法2：直接SQL查询（适合复杂场景） #

如果你的查询逻辑非常复杂，或者需要极致的性能，可以直接写SQL查询订单ID，再通过wc_get_order()获取订单对象。这种方法需要自己处理分页，但能完全控制查询逻辑。

示例代码： #

global $wpdb;
$product_id = 123;
$per_page = 2;
$current_page = 1;
$offset = ( $current_page - 1 ) * $per_page;

// 查询符合条件的订单ID（去重）
$order_ids = $wpdb->get_col( $wpdb->prepare( "
    SELECT DISTINCT p.ID
    FROM {$wpdb->posts} p
    INNER JOIN {$wpdb->prefix}woocommerce_order_items oi ON p.ID = oi.order_id
    INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta oim ON oi.order_item_id = oim.order_item_id
    WHERE p.post_type = 'shop_order'
    AND p.post_status IN ( 'wc-completed', 'wc-processing' ) // 按需筛选订单状态
    AND oim.meta_key = '_product_id'
    AND oim.meta_value = %d
    ORDER BY p.post_date DESC
    LIMIT %d OFFSET %d
", $product_id, $per_page, $offset ) );

// 获取订单对象数组
$orders = array_map( 'wc_get_order', $order_ids );

// 查询总订单数用于分页
$total_orders = $wpdb->get_var( $wpdb->prepare( "
    SELECT COUNT(DISTINCT p.ID)
    FROM {$wpdb->posts} p
    INNER JOIN {$wpdb->prefix}woocommerce_order_items oi ON p.ID = oi.order_id
    INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta oim ON oi.order_item_id = oim.order_item_id
    WHERE p.post_type = 'shop_order'
    AND p.post_status IN ( 'wc-completed', 'wc-processing' )
    AND oim.meta_key = '_product_id'
    AND oim.meta_value = %d
", $product_id ) );
$total_pages = ceil( $total_orders / $per_page );

方法3：WooCommerce REST API（适合外部/前端调用） #

如果你是在前端应用、移动端或者外部系统中查询订单，WooCommerce REST API是更合适的选择。API原生支持按产品ID筛选，并且自动处理分页。

示例请求（GET）： #

/wp-json/wc/v3/orders?line_items.product_id=123&per_page=2&page=1&orderby=date&order=desc

你可以通过API密钥授权访问，返回的结果会包含total和total_pages字段，直接用于分页逻辑。

方法对比： #

• 方法1：最符合WooCommerce开发规范，代码可维护性高，分页逻辑完全兼容原有WC_Order_Query的分页机制，推荐优先使用。
• 方法2：性能最优，适合超大规模订单的查询，但需要手动处理表前缀、订单状态和分页，代码复杂度稍高。
• 方法3：适合跨系统调用，无需后端PHP开发，但需要处理API授权和请求逻辑。

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