如何通过AJAX实现WooCommerce购物车商品数量动态更新功能？

以下是直接可落地的修复步骤：

• 修复AJAX参数名不匹配问题
  你的JS代码中传递购物车项标识的参数名为hash，但PHP处理函数中取值用的是$_REQUEST['cart_item_key']，参数名对应不上导致$cart_item_key为空，是操作失效的核心原因。
  修复方法：将JS代码中请求参数的hash: cart_item_key改为cart_item_key: cart_item_key，保持前后端参数名一致。
• 添加购物车初始化逻辑
  AJAX请求触发时WooCommerce可能未加载当前用户的购物车会话，需要手动初始化确保WC()实例和前端会话匹配。
  修复方法：在PHP处理函数开头添加wc_load_cart();。
• 补充参数校验与类型转换
  前端传递的quantity为字符串类型，直接运算可能出现类型错误，同时缺少合法性校验容易触发500错误。
  修复后的完整PHP处理函数如下：

  function updateCartQuantity(){
      // 初始化当前用户购物车
      wc_load_cart();
  
      // 校验必要参数是否存在
      if( !isset($_REQUEST['cart_item_key'], $_REQUEST['quantity'], $_REQUEST['value']) ) {
          wp_send_json_error('缺少必要参数');
      }
  
      // 输入过滤与类型转换
      $cart_item_key = sanitize_text_field($_REQUEST['cart_item_key']);
      $quantity = intval($_REQUEST['quantity']);
      $value = intval($_REQUEST['value']);
      $new_qty = $quantity + $value;
  
      // 校验数量合法性
      if( $new_qty < 0 ) {
          wp_send_json_error('商品数量不能小于0');
      }
  
      // 校验目标商品是否存在于购物车
      if( !WC()->cart->get_cart_item($cart_item_key) ) {
          wp_send_json_error('商品不存在于购物车中');
      }
  
      // 执行更新
      $update_result = WC()->cart->set_quantity($cart_item_key, $new_qty);
  
      if( $update_result ) {
          wp_send_json_success($new_qty);
      } else {
          wp_send_json_error('更新失败，请检查商品库存限制');
      }
  
      wp_die();
  }
  add_action( 'wp_ajax_nopriv_update_cart', 'updateCartQuantity' );
  add_action( 'wp_ajax_update_cart', 'updateCartQuantity' );
  

• 可选优化
  成功回调中可新增页面数量同步逻辑，无需刷新页面即可看到更新结果；如果仍然报错可临时开启WordPress调试模式，查看具体错误日志定位库存限制、商品类型不兼容等边缘问题。

内容的提问来源于stack exchange，提问作者Rasmus Lian