本文详解在 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'));
}
?>
? 关键优化点：
- 使用 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 主题/插件的基石。
