WooCommerce REST API：高效批量更新/创建可变产品的方法

一、无批量API支持时的逐条写入优化 #

如果必须逐条处理变体，可通过以下方式大幅提升效率：

1. 后台异步分批处理 #

避免在前端请求中同步处理所有变体，改用WordPress的后台任务机制：

• 基于WP_Async_Request实现异步请求类，将变体数据拆分为每50-100条为一个批次，后台逐步处理，不会阻塞用户操作或触发超时。
• 示例异步任务框架：

class Variation_Import_Async extends WP_Async_Request {
    protected $action = 'variation_import_batch';

    protected function handle() {
        if ( ! isset( $_POST['variations'] ) ) return;
        $variations = json_decode( stripslashes( $_POST['variations'] ), true );
        
        foreach ( $variations as $variation_data ) {
            wc_create_product_variation( $variation_data['parent_id'], $variation_data['args'] );
        }
    }
}

// 触发异步任务
$async = new Variation_Import_Async();
$async->data( ['variations' => $batch_variations] )->dispatch();

2. 削减API请求开销 #

• 启用HTTP持久连接：在API请求中添加Connection: keep-alive头部，避免每次请求重新建立TCP连接：

$args = [
    'headers' => [
        'Authorization' => 'Basic ' . base64_encode( WC_KEY . ':' . WC_SECRET ),
        'Connection' => 'keep-alive'
    ],
    'body' => json_encode( $variation_data )
];
wp_remote_post( WC_API_URL . '/products/' . $parent_id . '/variations', $args );

• 精简响应数据：请求时通过_fields参数只获取必要字段（如仅返回变体ID），减少数据传输量：

$url = WC_API_URL . '/products/' . $parent_id . '/variations?_fields=id';

3. 数据库直写（需谨慎） #

跳过REST API直接操作WooCommerce数据库表，速度比API快数倍：

• 变体存储在wp_posts表（post_type = 'product_variation'，post_parent关联主产品ID），属性、价格等元数据存在wp_postmeta表。
• 示例代码片段：

// 创建变体帖子
$variation_id = wp_insert_post( [
    'post_title' => 'Product Variation',
    'post_type' => 'product_variation',
    'post_status' => 'publish',
    'post_parent' => $parent_product_id
] );

// 写入变体元数据
update_post_meta( $variation_id, '_regular_price', '99.99' );
update_post_meta( $variation_id, '_stock_quantity', 50 );
update_post_meta( $variation_id, '_attribute_pa_color', 'red' );

// 触发必要钩子维护数据一致性
do_action( 'woocommerce_new_product_variation', $variation_id );

注意：需确保熟悉WooCommerce数据表结构，操作前备份数据库，避免破坏数据完整性。

二、WooCommerce REST API批量处理变体的方案 #

实际上，WooCommerce的批量产品API支持在创建/更新主产品时附带变体数据，无需单独调用变体API：

批量创建主产品+变体 #

使用POST /wp-json/wc/v3/products/batch接口，在每个主产品对象中加入variations数组，一次性创建主产品和所有关联变体：

$batch_payload = [
    'create' => [
        [
            'name' => '可变产品A',
            'type' => 'variable',
            'attributes' => [
                [
                    'name' => '颜色',
                    'slug' => 'pa_color',
                    'variation' => true,
                    'options' => ['红色', '蓝色']
                ]
            ],
            'variations' => [
                [
                    'attributes' => [['name' => '颜色', 'option' => '红色']],
                    'regular_price' => '89',
                    'stock_quantity' => 100
                ],
                [
                    'attributes' => [['name' => '颜色', 'option' => '蓝色']],
                    'regular_price' => '99',
                    'stock_quantity' => 80
                ]
            ]
        ],
        // 更多主产品...
    ]
];

$response = wp_remote_post(
    get_rest_url( null, 'wc/v3/products/batch' ),
    [
        'headers' => [
            'Authorization' => 'Basic ' . base64_encode( WC_CONSUMER_KEY . ':' . WC_CONSUMER_SECRET ),
            'Content-Type' => 'application/json'
        ],
        'body' => json_encode( $batch_payload )
    ]
);

批量更新已有主产品的变体 #

在批量更新主产品时，通过指定变体id来修改现有变体，或新增变体到variations数组中：

$batch_payload = [
    'update' => [
        [
            'id' => $existing_parent_id,
            'variations' => [
                [
                    'id' => $existing_variation_id,
                    'regular_price' => '109' // 更新价格
                ],
                [
                    'attributes' => [['name' => '颜色', 'option' => '绿色']],
                    'regular_price' => '119',
                    'stock_quantity' => 60 // 新增变体
                ]
            ]
        ]
    ]
];

注意事项 #

• 批量请求建议控制在20-50个主产品/批次，避免超出服务器的请求大小或超时限制。
• 所有操作前务必备份数据库，尤其是批量操作和数据库直写场景。
• 测试阶段先用小批量数据验证逻辑，确认无误后再扩大处理规模。

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