Prestashop重写CartController时如何获取当前商品组合库存数量

你当前读取的$product->quantity是商品主表记录的全规格汇总库存值，天然不对应单个选中规格的实际库存。PrestaShop体系内商品的不同规格组合（也就是不同属性搭配的SKU）是独立的库存单元，对应唯一的id_product_attribute标识，库存是单独存储的。

• 先从当前处理的购物车条目里取到对应规格组合的ID id_product_attribute，购物车表本身就会存储每个加购项对应的组合ID，不要从全局商品对象里取这个值
• 优先调用核心内置的库存查询方法获取指定组合的实时可售库存，不要直接读取商品主对象的库存字段
• 同步调整库存校验方法的传参，确保校验逻辑也用对应组合的库存判断，避免前端显示改了但实际校验规则还是走总库存的问题

// 从当前购物车条目获取规格组合ID，如果你当前逻辑段已经有该变量可直接使用
$idProductAttribute = (int)($cartItem['id_product_attribute'] ?? 0);
$availableQty = 0;

if ($idProductAttribute > 0) {
    // 带规格的商品，调用核心库存类读取指定组合的当前店铺可用库存
    // 该方法会自动处理多店铺、预留库存、out of stock配置的逻辑，结果最准确
    $availableQty = (int)\StockAvailable::getQuantityAvailableByProduct(
        $product->id,
        $idProductAttribute,
        $this->context->shop->id
    );
} else {
    // 无规格的普通商品，直接读取商品库存即可
    $availableQty = (int)$product->quantity;
}

// 原逻辑调整，注意给shouldAvailabilityErrorBeRaised传组合ID，确保校验逻辑匹配
if ('update' !== $mode && $this->shouldAvailabilityErrorBeRaised($product, $qty_to_check, $idProductAttribute)) {
   $this->{$ErrorKey}[] = $this->trans(
      'The item %product% in your cart is no longer available in this quantity. You cannot proceed with your order until the quantity is adjusted. Available quantity: %productQuantity%, requested quantity: %productCheck%.',
            [
                '%product%' => $product->name,
                '%productQuantity%' => $availableQty,
                '%productCheck%' => $qty_to_check
            ],
            'Shop.Notifications.Error'
   );
}

• 如果你原来的shouldAvailabilityErrorBeRaised方法没有预留组合ID的入参，需要同步重写该方法，把内部的库存查询逻辑也替换成按组合查询的逻辑，否则校验结果会和显示的库存数不一致
• 不要直接通过new ProductAttribute($idProductAttribute)->quantity拿库存，这个值不会计算购物车预留库存、多店铺库存隔离的规则，只适合后台读原始库存值用，前台校验一定要走StockAvailable类的查询方法
• 如果是批量处理购物车所有条目，建议提前一次性批量查询所有涉及商品/组合的库存，避免循环查询数据库带来性能损耗

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