如何避免自定义文章类型中按分类法查询时出现重复内容

本文详解在 wordpress 自定义文章类型（如 products）中，使用 acf 分类法字段筛选时因多分类关联导致内容重复的问题，并提供两种高效、无重复的解决方案：单次联合查询与去重缓存机制。

在开发基于自定义文章类型（如 product）的产品展示页时，若产品可归属多个分类（如 product_category），而前端又通过 ACF 的「Taxonomy Field」获取用户勾选的多个分类并逐个查询，极易引发内容重复——例如一个同时属于 laptops 和 business 的产品，会在两个循环中各输出一次。

根本原因在于原始逻辑采用了「分类驱动循环」：先遍历分类，再对每个分类单独执行 WP_Query。这本质上是 N 次独立查询，完全不感知跨分类的 ID 重叠。

✅ 推荐方案一：一次性查询 + 多分类匹配（最优解）
将多次循环查询合并为一次，利用 tax_query 的 'operator' => 'IN'（默认）行为，直接检索属于任一指定分类的所有产品，并自动去重：

 'product',
    'post_status'    => 'publish',
    'posts_per_page' => -1, // 根据需要调整，建议分页
    'tax_query'      => array(
        array(
            'taxonomy' => $custom_taxonomy,
            'field'    => 'slug',
            'terms'    => $term_slugs,
            // 'operator' => 'IN' — 默认即为此值，表示“属于任意其一”
        ),
    ),
    'orderby'        => 'date',
    'order'          => 'DESC'
);

$loop = new WP_Query($args);

if ($loop->have_posts()) :
    $product_coming_soon_image = get_field('product_coming_soon_image');

    while ($loop->have_posts()) : $loop->the_post();
        // 获取当前产品所属的所有 product_category 分类 slug，用于 CSS 类名
        $terms = get_the_terms(get_the_ID(), $custom_taxonomy);
        $terms_classes = '';
        if ($terms && !is_wp_error($terms)) {
            $terms_classes = implode(' ', wp_list_pluck($terms, 'slug'));
        }
        ?>

         isotope-item">
            ">
                
                    @@##@@" 
                         class="lazy" 
                         alt="" 
                         loading="lazy" 
                         width="240" height="240">
                
                    
                        @@##@@" 
                             alt="" 
                             loading="lazy" 
                             width="240" height="240">
                    
                
            
            
">
        

    

? 关键优化点：

• 使用 array_column($product_categories, 'slug') 统一提取 slug，避免手动 foreach；
• wp_reset_postdata() 替代已弃用的 wp_reset_query()，确保不影响后续模板逻辑；
• esc_attr() 包裹动态类名与属性值，提升安全性；
• 图片尺寸建议使用预设缩略图尺寸（如 'medium'），而非空字符串，保障性能与一致性。

⚠️ 备选方案二：循环中动态排除已输出 ID（仅限必须按分类分组时）
若业务要求严格按分类顺序分区块展示（如每个分类标题下罗列对应产品），则需在循环中维护已处理 ID 集合，并在每次查询中排除：

 'product',
        'post_status'    => 'publish',
        'post__not_in'   => $seen_ids, // 关键：跳过已输出的 ID
        'tax_query'      => array(
            array(
                'taxonomy' => $custom_taxonomy,
                'field'    => 'slug',
                'terms'    => $custom_term->slug,
            ),
        ),
        'posts_per_page' => -1,
    );

    $loop = new WP_Query($args);

    if ($loop->have_posts()) :
        while ($loop->have_posts()) : $loop->the_post();
            $post_id = get_the_ID();
            $seen_ids[] = $post_id; // 记录已输出

            // ... 渲染逻辑同上 ...
        endwhile;
        wp_reset_postdata();
    endif;
endforeach;
?>

? 总结：
重复问题本质是查询粒度与数据关系不匹配所致。优先采用「单次多分类查询」，简洁、高效、符合 WordPress 最佳实践；仅当 UI 强制要求分类分组时，才引入 post__not_in 缓存机制，并务必注意内存占用（大量产品时需考虑分页或异步加载）。同时，始终校验 ACF 字段返回值、使用安全输出函数、重置查询上下文，是构建健壮 WordPress 主题/插件的基石。