本文介绍使用 Laravel 的 increment() 方法高效实现多行记录数值字段的累加更新，避免手动读取-修改-写入流程，提升性能与代码简洁性。
本文介绍使用 laravel 的 `increment()` 方法高效实现多行记录数值字段的累加更新，避免手动读取-修改-写入流程，提升性能与代码简洁性。
在实际开发中，常需对多个商品库存、账户余额或计数器等数值型字段执行“在原有值基础上增加新值”的操作。例如：产品 A 当前库存为 20，需新增入库 5；产品 B 当前为 25，新增 4 —— 最终期望结果分别为 25 和 29。若沿用传统 update() 方式（先查再改），不仅逻辑冗余、易引发竞态条件，还显著降低性能。
Laravel 提供了原子化、安全且高效的 increment() 方法，可直接在数据库层面完成“读取 + 加法 + 写入”三步操作，无需应用层干预，天然规避并发冲突。
✅ 推荐实现方式（基于 Eloquent）：
假设前端提交的数据结构为关联数组，键为 product_id，值为待增加的 quantity：
// 示例请求数据（通常来自 $request->all() 或预处理）
$productsWithQty = [
1 => 5, // product_id=1 增加 5
2 => 4, // product_id=2 增加 4
];
// 批量递增更新（每条记录独立执行，线程安全）
foreach ($productsWithQty as $productId => $incrementBy) {
Product::findOrFail($productId)->increment('quantity', $incrementBy);
}? 关键优势说明：
- 原子性保障：increment() 底层生成 UPDATE ... SET quantity = quantity + ? SQL，由数据库保证操作不可分割；
- 零竞态风险：无需 SELECT 查询当前值，彻底消除“读旧值 → 算新值 → 写新值”过程中的并发覆盖问题；
- 简洁可靠：代码行数少、意图清晰、异常时自动抛出 ModelNotFoundException，便于错误捕获与回滚。
⚠️ 注意事项：
- 若需同时更新多个字段（如 quantity 和 updated_at），increment() 不适用，应改用 update() 配合 DB::raw()（例：['quantity' => DB::raw('quantity + 5'), 'updated_at' => now()]）；
- 大批量（如 >1000 条）更新建议改用 DB::table()->upsert() 或原生批量 SQL，避免 N+1 查询开销；
- 始终校验输入 ID 是否真实存在（findOrFail() 已处理），防止静默失败。
? 进阶提示（批量优化）：
对于极高并发场景，可结合数据库事务与锁机制（如 sharedLock() / lockForUpdate()），但多数业务中 increment() 已足够健壮。如需单次 SQL 完成全部更新，可借助 DB::statement() 执行原生 INSERT ... ON DUPLICATE KEY UPDATE（MySQL）或 INSERT ... ON CONFLICT（PostgreSQL），但需确保表结构支持唯一约束。
综上，increment() 是 Laravel 中处理“累加更新”类需求的标准、首选方案——语义明确、性能优异、安全可靠。
