调用WooCommerce产品API时出现重复产品（同ID不同related_ids）的咨询

这个问题大概率是因为产品查询时关联了related_ids对应的关联产品表，导致同一产品因为关联关系的不同组合被多次查询出来，最终在接口返回中重复出现。下面是几个可行的解决方法：

方法1：通过查询过滤器添加DISTINCT去重 #

WooCommerce提供了woocommerce_rest_product_object_query过滤器，我们可以利用它在产品查询中添加DISTINCT参数，强制数据库返回唯一的产品记录。

将以下代码添加到你的主题functions.php文件或者自定义插件中：

add_filter( 'woocommerce_rest_product_object_query', 'rest_remove_duplicate_products', 10, 2 );
function rest_remove_duplicate_products( $query_args, $request ) {
    // 启用DISTINCT，确保每个产品只返回一次
    $query_args['distinct'] = true;
    return $query_args;
}

这个方法从数据库查询层面解决重复问题，效率较高，优先推荐。

方法2：在响应返回前手动去重 #

如果方法1没有生效，你可以在API响应返回给客户端之前，手动遍历产品列表，根据产品ID去重。

使用woocommerce_rest_prepare_products_response过滤器实现：

add_filter( 'woocommerce_rest_prepare_products_response', 'rest_response_remove_duplicate_products', 10, 3 );
function rest_response_remove_duplicate_products( $response, $products, $request ) {
    $unique_products = [];
    
    // 遍历产品，用ID作为键确保唯一性
    foreach ( $products as $product ) {
        $unique_products[ $product->get_id() ] = $product;
    }
    
    // 更新响应中的产品列表和计数信息
    $response->data['products'] = array_values( $unique_products );
    $response->data['total'] = count( $unique_products );
    $response->data['total_pages'] = ceil( count( $unique_products ) / $request['per_page'] );
    
    return $response;
}

这个方法在数据返回前处理，适合查询层面无法解决的场景，但如果产品数量很大，可能会有轻微的性能影响。

方法3：排查自定义代码/插件干扰 #

如果上面两个方法都没用，建议暂时禁用所有第三方插件，切换到WooCommerce默认主题（比如Storefront），再测试API接口。这能帮你排查是否是某个自定义代码或者插件修改了产品查询逻辑，导致重复结果出现。

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