本文详解如何在 WooCommerce 中精准识别并修改特定变体商品（如 ID 18653）加入购物车时的数量，避免因混淆 $product_id 与 $variation_id 导致的循环调用和致命错误。
本文详解如何在 woocommerce 中精准识别并修改特定变体商品（如 id 18653）加入购物车时的数量，避免因混淆 `$product_id` 与 `$variation_id` 导致的循环调用和致命错误。
在 WooCommerce 开发中，woocommerce_add_cart_item_data 钩子常被误用于“强制添加其他商品”或“修改数量”，但该钩子的核心职责是扩展或修改当前待添加商品的 cart item 数据（如自定义元字段），而非触发二次 add_to_cart 操作。您原始代码中的问题在于：
- 在 woocommerce_add_cart_item_data 回调内直接调用 WC()->cart->add_to_cart(15)，会再次触发该钩子，造成无限递归，最终导致 PHP 内存耗尽或 500 错误；
- 对于变体商品（如 ID 18653），$product_id 参数实际传递的是父级可变产品（variable product）的 ID，而非变体自身 ID；而 $variation_id 才是变体的真实 ID（18653）。但 woocommerce_add_cart_item_data 的第三个参数 $variation_id 在非变体场景下为 0，需谨慎判空。
✅ 正确做法：若目标仅为调整某变体加入购物车时的数量（例如将变体 18653 默认加购 15 件），应使用 woocommerce_add_to_cart_quantity 过滤器：
add_filter('woocommerce_add_to_cart_quantity', 'set_custom_cart_quantity_for_variation', 10, 2);
function set_custom_cart_quantity_for_variation($quantity, $product_id) {
// 注意：此处 $product_id 是父级 variable product ID（如 18651）
// 但 WooCommerce 在添加变体时，仍会将父级 product ID 传入此过滤器
// 若需精确匹配变体 18653，需结合 $_POST 或 session 上下文 —— 更稳妥方案见下方进阶说明
if (18651 === $product_id && isset($_POST['variation_id']) && 18653 == intval($_POST['variation_id'])) {
return 15;
}
return $quantity;
}⚠️ 重要提醒：
- woocommerce_add_to_cart_quantity 中 $product_id 始终为父级商品 ID（即 variable product ID），不是变体 ID。因此仅靠 $product_id == 18653 永远不会命中——因为变体本身没有独立的“产品 ID”用于此过滤器。
- 若要严格按变体 ID（18653）定制逻辑，推荐使用 woocommerce_add_cart_item_from_request 或在 woocommerce_add_to_cart_redirect 前检查 $_REQUEST，但最简洁可靠的方式仍是利用 woocommerce_add_cart_item_data 安全地注入自定义数据，再通过 woocommerce_get_cart_item_from_session 和 woocommerce_cart_item_from_cart 等钩子联动控制行为。
? 总结：
- ❌ 避免在 woocommerce_add_cart_item_data 中调用 add_to_cart()；
- ✅ 数量控制优先用 woocommerce_add_to_cart_quantity，并理解其 $product_id 指向父商品；
- ? 如需精确识别变体，应结合 $_POST['variation_id'] 或 $_POST['variation'] 数组进行判断；
- ?️ 所有钩子回调务必 return 原始值（或修改后值），否则可能破坏购物车流程。
