本文介绍如何通过自定义查询过滤 WooCommerce 商品列表，自动排除未设置特色图像（缩略图）的商品，确保前台仅展示带有有效缩略图的产品。
本文介绍如何通过自定义查询过滤 WooCommerce 商品列表，自动排除未设置特色图像（缩略图）的商品，确保前台仅展示带有有效缩略图的产品。
在 WooCommerce 中，商品缩略图（Featured Image）不仅是视觉呈现的关键元素，也常作为筛选或布局逻辑的依据。若希望前台（如商品目录页、搜索结果、小工具等）自动隐藏所有未设置缩略图的商品，需修改 WooCommerce 的主查询逻辑——而非依赖前端 CSS 隐藏，因为后者仍会加载无效商品，影响性能与 SEO。
正确的实现方式是利用 woocommerce_product_query 钩子，对 WP_Query 对象进行精准干预。您提供的原始代码存在两个关键问题：
- 使用 meta_query 匹配 _thumbnail_id > 0 逻辑不成立——_thumbnail_id 是一个 post meta 字段，其值为附件 ID（整数），但当未设置缩略图时，该 meta 根本不存在（而非存储为 0 或空字符串）；
- meta_query 中 value => '0' 和 compare => '>' 的组合无法匹配“字段缺失”的情形，反而可能引入意外结果。
✅ 正确且简洁的解决方案如下：
function woocommerce_product_query_has_thumbnail( $query ) {
// 要求 _thumbnail_id meta 必须存在（即非空）
$query->set( 'meta_key', '_thumbnail_id' );
}
add_action( 'woocommerce_product_query', 'woocommerce_product_query_has_thumbnail' );将上述代码添加至当前启用主题的 functions.php 文件末尾即可生效。该方案原理是：WordPress 查询中，当仅设置 meta_key（不设 meta_value）时，WP_Query 会自动转换为 EXISTS 子句，即只返回包含该 meta 键的 posts —— 这正是我们所需的“有缩略图”语义。
⚠️ 注意事项：
- 此过滤会影响所有 WooCommerce 商品主查询，包括首页商品区块、分类页、搜索页及 REST API /wp-json/wc/store/products 等（除非插件/主题显式绕过）；
- 若需局部控制（例如仅在某分类下隐藏），可在函数内增加条件判断，如 if ( is_product_category('shoes') ) { ... }；
- 已缓存页面（如使用 WP Super Cache、Redis 等）需清除缓存后生效；
- 建议搭配「强制为所有商品设置默认缩略图」策略（如用 woocommerce_placeholder_img_src 过滤器），避免出现空白占位，提升用户体验。
? 扩展提示：如需反向操作（仅显示无缩略图的商品，用于批量修复），可改用 meta_query 的 NOT EXISTS：
$query->set( 'meta_query', array(
array(
'key' => '_thumbnail_id',
'compare' => 'NOT EXISTS'
)
) );综上，通过合理利用 WordPress 查询机制，无需复杂 SQL 或额外数据库查询，即可轻量、高效地实现 WooCommerce 商品缩略图驱动的可见性控制。
