本文介绍一种基于 laravel 的库存扣减策略，当同一商品存在多条库存记录（如来自不同订单）时，按优先级顺序（如 id_order）逐条扣减，确保不超卖且精准分配。
在实际电商或仓储系统中，同一商品（如 id_wine = 1）可能因分批入库、多渠道采购等原因，在数据库中存在多条库存记录，每条对应不同来源（如不同 id_order）和独立可用数量（quantita_restante）。此时若用户一次性下单 5 瓶，而库存分散为 4 + 1，直接对“第一条记录”执行 decrement('quantita_restante', 5) 将导致负库存（如 4 − 5 = −1），违反业务约束。
正确做法是：按预设顺序遍历所有可用库存记录，贪心式逐条扣减，直到订单数量耗尽。Laravel 原生不支持单条 SQL 完成跨行条件递减，因此需结合查询 + 循环 + 事务保障原子性。
以下是推荐实现方案（含事务与边界处理）：
use Illuminate\Support\Facades\DB;
$requestedQty = $request->quantita;
$wineId = $wine_id;
$restaurantId = Auth::user()->id_restaurant;
DB::transaction(function () use ($requestedQty, $wineId, $restaurantId) {
// 按 id_order 升序获取所有可用库存（先到先扣）
$stocks = warehouse::where('id_restaurant', $restaurantId)
->where('id_wine', $wineId)
->where('quantita_restante', '>', 0)
->orderBy('id_order')
->get();
$remaining = $requestedQty;
foreach ($stocks as $stock) {
if ($remaining <= 0) break;
// 当前库存可扣减量 = min(剩余需扣量, 当前库存余量)
$toDeduct = min($remaining, $stock->quantita_restante);
// 执行原子扣减（避免并发覆盖）
$affected = warehouse::where('id', $stock->id)
->where('quantita_restante', '>=', $toDeduct)
->decrement('quantita_restante', $toDeduct);
if ($affected === 0) {
throw new \Exception("库存并发冲突：记录 ID {$stock->id} 余量不足，无法扣减 {$toDeduct}");
}
$remaining -= $toDeduct;
}
if ($remaining > 0) {
throw new \Exception("库存不足：请求 {$requestedQty}，仅能分配 " . ($requestedQty - $remaining));
}
});✅ 关键要点说明：
- 顺序性保障：orderBy('id_order') 确保按入库/订单时间等业务逻辑确定扣减优先级；
- 防超卖：每条记录扣减前校验 quantita_restante >= toDeduct（通过 where() 条件实现乐观锁）；
- 事务安全：整个扣减过程包裹在 DB::transaction() 中，失败则全部回滚；
- 性能提示：若库存记录极多，可加索引 INDEX (id_restaurant, id_wine, id_order, quantita_restante) 提升查询效率；
- 扩展建议：可将此逻辑封装为仓库模型的静态方法（如 warehouse::reserve($wineId, $qty)），提升复用性。
该方案兼顾准确性、健壮性与可维护性，是处理“分布式库存聚合扣减”场景的标准实践。
