本文介绍如何在 Laravel 中高效、安全地对多条记录的指定数值字段执行累加更新操作，避免逐条查询再更新的低效方式，推荐使用内置的 increment() 方法实现原子性累加。
本文介绍如何在 laravel 中高效、安全地对多条记录的指定数值字段执行累加更新操作，避免逐条查询再更新的低效方式，推荐使用内置的 `increment()` 方法实现原子性累加。
在实际业务中（如库存管理），常需对多个商品的 quantity 字段进行“增量更新”——即在原有值基础上加上新输入的数量，而非直接覆盖。例如：商品 A 当前库存为 20，新增入库 5，则更新后应为 25；商品 B 原为 25，新增 4，更新后为 29。若沿用原始代码中先查再改、或使用 update() 全量覆盖的方式，不仅逻辑错误（会丢失原值），还存在并发风险与性能瓶颈。
Laravel 提供了原子性增减方法 increment() 和 decrement()，可直接在数据库层面完成 quantity = quantity + $value 操作，无需先读取当前值，既简洁又线程安全。
✅ 推荐实现方式（批量累加更新）：
// 假设请求数据结构为关联数组：[product_id => new_quantity_to_add]
$productsWithQty = [
1 => 5, // 商品 ID 1，增加 5
2 => 4, // 商品 ID 2，增加 4
];
foreach ($productsWithQty as $productId => $incrementAmount) {
Product::findOrFail($productId)->increment('quantity', $incrementAmount);
}
? 关键说明：
- increment('quantity', $amount) 等价于 SQL 的 UPDATE products SET quantity = quantity + ? WHERE id = ?；
- 第二个参数 $amount 可省略，默认为 1；
- findOrFail() 确保 ID 存在，避免静默失败，异常时自动抛出 ModelNotFoundException；
- 每次调用均为独立事务内原子操作，适用于中低频并发场景；如需更高一致性（如库存扣减防超卖），建议结合数据库行锁或 whereRaw 条件校验。
⚠️ 注意事项：
- ❌ 避免使用 Product::update(['id' => $id], $data) —— 此写法非 Laravel 标准语法（易报错），且无法实现累加；
- ❌ 不要手动 SELECT + UPDATE，既低效又易引发竞态条件（如两个请求同时读到旧值 20，各自加 5 后都写入 25，导致实际只加了 5 而非 10）；
- ✅ 若需一次执行多条 increment 并保证事务性，可包裹在 DB 事务中：
use Illuminate\Support\Facades\DB;
DB::transaction(function () use ($productsWithQty) {
foreach ($productsWithQty as $productId => $qty) {
Product::findOrFail($productId)->increment('quantity', $qty);
}
});
总结：利用 Laravel 的 increment() 方法，是实现多行数值字段安全累加更新的最佳实践——语义清晰、代码简练、数据库层原子保障，应作为库存、积分、浏览数等场景的默认方案。
