Yii框架本身不内置库存扣减逻辑,也不自动加锁;是否超卖完全取决于开发者选用forUpdate()、optimisticLock()或Redis+Lua等具体实现方式,框架不兜底。

直接说结论:Yii 框架本身不内置库存扣减逻辑,也**不自动加锁**;库存是否超卖、是否扣准,完全取决于你用的是 forUpdate()、optimisticLock(),还是绕开 ActiveRecord 直接走 Redis + Lua。别指望框架替你兜底。
用 forUpdate() 做数据库悲观锁扣库存
这是最贴近“传统 SQL 思路”的做法,适合小流量或强一致性要求高的场景(比如订单创建前的最终校验)。
- 必须在事务内调用,否则
forUpdate()无效 - 要确保 WHERE 条件能命中索引,否则会升级为表锁,拖垮整个库
- MySQL 默认隔离级别是
REPEATABLE READ,forUpdate锁的是当前读的行,不是快照 - 示例写法:
$transaction = Yii::$app->db->beginTransaction();
try {
$product = Product::find()
->where(['id' => $productId])
->forUpdate() // 关键:加排他锁
->one();
if ($product && $product->stock > 0) {
$product->stock--;
$product->save(false); // false 避免二次验证
} else {
throw new Exception('库存不足');
}
$transaction->commit();
} catch (Exception $e) {
$transaction->rollBack();
throw $e;
}
注意:forUpdate() 在 Yii 2 中不会自动重试,锁被其他事务占用时当前请求会阻塞,直到超时(默认 MySQL wait_timeout 是 28800 秒,但实际业务中应设更短的 innodb_lock_wait_timeout)。
用 optimisticLock() 防止并发更新丢失
它不锁数据库,靠版本号比对拦截“后提交者”,适合冲突概率低、读多写少的场景(如商品信息编辑),但**不适合秒杀类库存扣减**——因为失败率高、用户体验差。
- 表里必须有
version字段(类型推荐BIGINT DEFAULT 0) - Model 中必须重写
optimisticLock()返回字段名,例如return 'version'; - 更新语句会自动带上
WHERE version = ?,失败时抛出yii\db\StaleObjectException - 不能替代
forUpdate()做库存校验,因为版本号只在 save 时检查,中间状态不可控
典型错误:把 optimisticLock() 当成“无锁库存扣减”来用,结果在高并发下大量请求走到 save 阶段才失败,前端看到一堆“数据已被修改”,实际库存早被扣穿了。
用 Redis + set(..., ['NX', 'EX' => 5]) 实现分布式锁扣库存
这才是高并发电商真正落地的方案,和 Yii 框架解耦,只借它的 Redis 组件能力。
-
NX表示“仅当 key 不存在时才设置”,天然防重复抢 -
EX => 5是过期时间(秒),防止服务崩溃导致死锁 - 锁 key 必须带业务粒度,比如
stock_lock:123(123 是商品 ID),不能全用一个 key - 扣减必须用 Lua 脚本原子执行,避免先 get 再 decr 的竞态
示例 Lua 脚本(存在 Redis 中,PHP 里调用 eval):
if redis.call("GET", KEYS[1]) >= tonumber(ARGV[1]) then
return redis.call("DECRBY", KEYS[1], ARGV[1])
else
return -1
end
对应 PHP 调用:Yii::$app->redis->eval($luaScript, 1, "stock:123", 1)。注意:Redis 的 DECRBY 是原子的,但前提是库存初始值已预热进 Redis,且不与 MySQL 库存双写不同步。
为什么不能只靠 Yii 的 ActiveRecord 扣库存?
因为 ActiveRecord 是面向对象封装,它把“查→改→存”拆成三步,中间空档期就是超卖温床。哪怕你加了 forUpdate(),只要没包在事务里、或事务没覆盖完整链路(比如没锁住关联的订单表)、或用了长事务,就依然可能出问题。
真正难的不是写对一行代码,而是厘清锁的边界:这个锁要护住哪些数据?持续多久?失败后怎么降级?Redis 锁失效了要不要 fallback 到 DB 锁?这些 Yii 不管,得你设计清楚。











