优化WooCommerce可变商品的WC_Product_Query及代码性能

架构老林

2026-5-11

优化可变商品缺货变体清理函数的建议

首先回答你的第一个问题：当然可以用`wc_get_products()`仅返回可变商品！

只需要在你的$args数组里添加'type' => 'variable'参数，这样就不用在循环里再判断商品类型了，直接过滤出可变商品，减少不必要的判断：

$args = array(
    'status' => 'publish',
    'limit' => -1,
    'type' => 'variable' // 新增这个参数
);
$products = wc_get_products( $args );

接下来是针对大型站点的性能优化建议，分几个关键方向：

1. 减少不必要的数据加载，降低内存占用

只获取商品ID而非完整对象：当商品数量很多时，加载完整的WC_Product对象会消耗大量内存。可以用'fields' => 'ids'参数只获取商品ID，然后按需加载单个商品对象：

$args = array(
    'status' => 'publish',
    'limit' => -1,
    'type' => 'variable',
    'fields' => 'ids' // 只返回ID
);
$product_ids = wc_get_products( $args );

foreach ( $product_ids as $product_id ) {
    $product = wc_get_product( $product_id );
    // 后续逻辑...
}

替换get_available_variations()为更轻量的查询：get_available_variations()返回的是前端展示用的完整数据（包括价格、图片等），但你只需要库存状态和属性信息。可以直接获取变体ID列表，然后逐个加载变体对象：
```
// 替换原来的$variations = $product->get_available_variations();
$variation_ids = $product->get_children();
foreach ( $variation_ids as $variation_id ) {
    $variation = wc_get_product( $variation_id );
    if ( !$variation || !$variation->is_in_stock() ) {
        // 处理缺货变体...
    }
}
```
这样能避免加载大量无关数据，提升内存效率。

2. 批量操作替代逐个数据库调用

原代码中wp_delete_post()和wp_remove_object_terms()都是逐个执行，会产生大量数据库查询。可以先收集所有需要操作的对象，再批量处理：

$variations_to_delete = array();
$attributes_to_remove = array();

// 先收集所有需要处理的数据
foreach ( $product_ids as $product_id ) {
    $product = wc_get_product( $product_id );
    $variation_ids = $product->get_children();
    foreach ( $variation_ids as $variation_id ) {
        $variation = wc_get_product( $variation_id );
        if ( !$variation || !$variation->is_in_stock() ) {
            $variations_to_delete[] = $variation_id;
            // 收集属性信息
            $attributes = $variation->get_attributes();
            foreach ( $attributes as $taxonomy => $term_slug ) {
                $attributes_to_remove[] = array(
                    'product_id' => $product_id,
                    'taxonomy' => $taxonomy,
                    'term_slug' => $term_slug
                );
            }
        }
    }
}

// 批量删除变体
foreach ( $variations_to_delete as $var_id ) {
    wp_delete_post( $var_id, true );
    echo 'Deleted product variation ID #' . $var_id . '<br>';
}

// 批量移除属性
foreach ( $attributes_to_remove as $item ) {
    wp_remove_object_terms( $item['product_id'], $item['term_slug'], $item['taxonomy'] );
    echo 'Deleted product attribute (' . $item['taxonomy'] . ' - ' . $item['term_slug'] . ') for product ID #' . $item['product_id'] . '<br><br>';
}

虽然还是循环，但先收集再处理的方式可以减少逻辑中的嵌套，同时方便后续进一步优化为真正的批量数据库操作（比如用DELETE FROM wp_posts WHERE ID IN (...)，但要注意WooCommerce的关联数据清理）。

3. 添加分页处理，避免一次性加载过多数据

如果站点有几百个商品，一次性获取所有ID可能还是会有内存压力。可以用分页参数拆分处理：

$per_page = 50; // 每页处理50个商品
$page = 1;
while ( true ) {
    $args = array(
        'status' => 'publish',
        'limit' => $per_page,
        'page' => $page,
        'type' => 'variable',
        'fields' => 'ids'
    );
    $product_ids = wc_get_products( $args );
    if ( empty( $product_ids ) ) {
        break; // 没有更多商品，退出循环
    }
    // 处理当前页的商品...
    $page++;
}

这样每次只加载50个商品，内存占用会小很多。

4. 修复代码中的潜在问题

初始化$atts变量：原代码中$atts没有在每个变体循环前初始化，可能会导致之前变体的属性残留到下一个变体的处理中。应该在每个变体循环内添加$atts = array();。
修正库存判断逻辑：原代码用$variation['is_in_stock'] == ''判断缺货，这不准确，因为is_in_stock是布尔值。应该用!$variation->is_in_stock()（如果用变体对象的话）或者$variation['is_in_stock'] === false。

5. 临时禁用不必要的钩子（可选）

wp_delete_post会触发很多钩子（比如before_delete_post、delete_post等），如果你的场景不需要这些钩子执行额外操作，可以临时移除它们来提升速度：

// 删除前移除自定义钩子（注意不要移除WooCommerce核心清理钩子）
remove_action( 'before_delete_post', 'your_custom_action' );
// 执行删除操作
wp_delete_post( $var_id, true );
// 恢复钩子（如果需要的话）
add_action( 'before_delete_post', 'your_custom_action' );

6. 使用数据库事务（可选）

如果你的数据库支持事务（比如MySQL的InnoDB引擎），可以把批量操作包裹在事务中，提升性能同时保证原子性：

global $wpdb;
$wpdb->query( 'START TRANSACTION' );
try {
    // 执行所有删除和属性移除操作
    // ...
    $wpdb->query( 'COMMIT' );
} catch ( Exception $e ) {
    $wpdb->query( 'ROLLBACK' );
    echo 'Error: ' . $e->getMessage();
}

这样所有操作要么一起成功，要么一起回滚，避免部分操作失败导致数据不一致，同时减少数据库的提交次数，提升速度。

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