WooCommerce REST API优化：减少获取带变体产品的请求次数

嘿，这个场景我之前踩过坑！完全可以通过预加载一次性拉取所有带变体的产品，把请求次数从51次直接降到1次（最多2次如果产品数超过分页上限），根本不用逐个产品请求变体。下面给你详细讲怎么操作：

核心原理 #

WooCommerce REST API（v2及以上版本）支持嵌入关联资源的功能，你可以在获取产品列表的请求里，直接让API把每个产品的变体数据一起返回，不用再单独调用/products/{id}/variations端点。

具体实现步骤 #

1. 构造优化后的API请求 #

直接用这个GET请求（以v3版本为例）：

GET /wp-json/wc/v3/products?per_page=100&_embed=product_variations

拆解参数：

• per_page=100：WooCommerce允许的最大单页返回数是100，你的50个产品完全可以一次拉取；如果未来产品数超过100，只需要处理分页（比如请求page=2），总请求次数也远少于原来的N+1。
• _embed=product_variations：这个是关键！它会让API自动把每个产品对应的变体完整数据嵌入到返回的产品对象里，变体数据会放在_embedded.product_variations字段下。

2. 代码示例（以PHP官方客户端为例） #

如果你用的是WooCommerce官方PHP库，可以这么写：

use Automattic\WooCommerce\Client;

// 初始化客户端
$woocommerce = new Client(
    'https://你的店铺域名.com',
    '你的消费者密钥',
    '你的消费者密码',
    [
        'version' => 'wc/v3',
    ]
);

// 一次性拉取所有带变体的产品
$products = $woocommerce->get('products', [
    'per_page' => 100,
    '_embed' => 'product_variations'
]);

// 遍历产品和变体
foreach ($products as $product) {
    echo "产品名称：{$product->name}\n";
    // 检查是否有变体
    if (!empty($product->_embedded->product_variations)) {
        foreach ($product->_embedded->product_variations as $variation) {
            echo "  - 变体SKU：{$variation->sku}，价格：{$variation->price}\n";
        }
    }
}

3. 其他可选方式（仅获取变体ID） #

如果你只需要变体的ID而不是完整数据，可以用_fields参数指定返回字段，这样响应体积更小：

GET /wp-json/wc/v3/products?per_page=100&_fields=id,name,variations

不过这种方式返回的variations是变体ID的数组，不是完整数据，适合只需要ID的场景。

优化效果对比 #

• 原来的方式：1次产品列表请求 + 50次变体请求 = 51次HTTP请求
• 优化后：1次请求（最多2次分页请求）就拿到所有产品+变体数据，请求次数减少98%以上，同时也降低了服务器的负载和网络延迟。

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