本文介绍如何通过 woocommerce_product_query 钩子，在商品库存低于设定值（如保留 20 件用于其他渠道销售）时，自动从商店首页、分类页、搜索结果等前端循环中排除特定商品，确保其不被展示。
本文介绍如何通过 woocommerce_product_query 钩子，在商品库存低于设定值（如保留 20 件用于其他渠道销售）时，自动从商店首页、分类页、搜索结果等前端循环中排除特定商品，确保其不被展示。
在 WooCommerce 开发中，有时需要为特定商品预留一定数量的库存（例如 20 件），使其不再参与前台销售展示，但仍保留在后台可管理、可手动下单或对接第三方系统。此时，简单地启用「隐藏缺货商品」全局设置（woocommerce_hide_out_of_stock_items）并不够——它仅基于「是否为 0」判断，无法按自定义阈值（如 ≤176）触发隐藏逻辑。
正确的实现方式是利用 woocommerce_product_query 这一关键动作钩子。该钩子在 WooCommerce 查询商品列表前执行，允许你动态修改 WP_Query 参数，从而精准控制哪些商品应被排除。以下为推荐代码（建议添加至当前主题的 functions.php 或专用插件中）：
add_action('woocommerce_product_query', 'hide_specific_products_from_shop', 20, 2);
function hide_specific_products_from_shop($q, $query) {
// 后台管理页面无需处理，避免干扰产品编辑等操作
if (is_admin()) {
return;
}
// 指定需受控的商品 ID（支持扩展为数组，见下方说明）
$target_product_id = 2004891;
// 获取商品实例并检查库存
$product = wc_get_product($target_product_id);
if (!$product) {
return; // 商品不存在则跳过
}
$current_stock = $product->get_stock_quantity();
$reserved_threshold = 176; // 即：当库存 ≤176 时开始隐藏（相当于预留 ≥20 件）
if ($current_stock !== null && $current_stock <= $reserved_threshold) {
// 将该商品 ID 加入排除列表；若已有其他排除项，需合并处理
$excluded_ids = (array) $q->get('post__not_in');
$excluded_ids[] = $target_product_id;
$q->set('post__not_in', array_unique($excluded_ids));
}
}✅ 优势说明：
- ✅ 作用于所有前端商品查询场景：商店首页、分类归档页、搜索结果、AJAX 加载（如无限滚动）、WooCommerce REST API（需额外适配）；
- ✅ 不影响后台管理、订单创建、手动添加到购物车（如通过直接 URL 访问商品页仍可购买）；
- ✅ 支持多商品扩展：将 $target_product_id 替换为数组（如 [2004891, 2004895, 2004902]），并在循环中逐一检查库存；
- ✅ 安全健壮：增加 wc_get_product() 存在性校验与 is_admin() 判断，防止潜在错误或后台异常。
⚠️ 注意事项：
- 请勿使用 pre_option_woocommerce_hide_out_of_stock_items 钩子进行此类逻辑——该选项仅控制全局“库存为 0 时是否隐藏”，且其返回值是字符串 'yes'/'no'，无法按商品粒度动态生效；
- 若需彻底禁用某商品的所有前台访问（包括单个商品页），应配合 template_redirect 钩子做 404 或重定向，但需谨慎评估 SEO 与用户体验影响；
- 建议对高频访问站点启用对象缓存（如 Redis），并考虑库存变更后清除相关查询缓存，确保隐藏逻辑实时生效。
通过上述方案，你即可精准实现“库存保留策略”，让 WooCommerce 更灵活地适配多渠道销售协同场景。
