仓储库存为什么不能只用一个 stock 字段？一次讲清可用库存、锁定库存、在途库存与账本设计

仓储库存为什么不能只有一个 stock 字段？可用、锁定、在途、账本一次讲透

这篇直接按库存账本来拆，不只讲“一个 stock 字段不够”，而是把可用、锁定、在途、冻结这些口径怎么落讲具体。
目标是你看完后，能把库存从一个数字，升级成多口径、可追溯的账本模型。

🦅个人主页
🐼GitHub主页

先看真实业务：为什么这块在仓储里总是容易出事

库存最容易出问题的地方，就是业务口径和技术口径混在一起。

• 订单占用和真实出库是两回事
• 仓间调拨期间库存既不在原仓可用，也不在目标仓可售
• 盘点和人工调整都需要清晰落账

真实业务场景我会怎么抽象

• 订单支付前后涉及锁定库存和释放库存
• 调拨单要体现源仓扣减和目标仓在途
• 盘点差异要产生盘盈盘亏调整

1. 所有业务动作先映射成库存账本动作
2. 账本动作再更新余额和流水
3. 库存口径通过账本字段表达，而不是靠业务猜

举个具体例子：放到项目里会怎么跑

比如用户下单后库存先从可用转到锁定，真正出库后再从锁定转到已扣减，这就是库存账本比“一个 stock 字段”更有价值的地方。

1. 下单预占时减少 available，增加 locked。
2. 取消订单时把 locked 回滚到 available。
3. 发货成功后再真正扣减 locked。
4. 每一步都写库存流水，方便追账。

代码示例：把可用库存转成锁定库存

@Transactionalpublicvoidreserve(LongwarehouseId,LongskuId,intqty){StockBalancebalance=stockBalanceRepo.mustGet(warehouseId,skuId);if(balance.getAvailableQty()<qty){thrownewIllegalStateException("stock not enough");}balance.setAvailableQty(balance.getAvailableQty()-qty);balance.setLockedQty(balance.getLockedQty()+qty);stockBalanceRepo.save(balance);ledgerRepo.save(StockLedger.reserve(warehouseId,skuId,qty));}

核心数据模型我会怎么定

• 余额表至少区分 totalStock、availableStock、lockedStock、inTransitStock
• 库存流水要带前值、变更值、后值和来源单据
• 库存调整要单独记录调整原因和责任人

系统设计我会优先拆哪几块

余额层

• 承载库存当前快照
• 按仓、SKU、批次等维度存放余额

流水层

• 每次库存变化都产生流水
• 用于审计、排障和账实复盘

口径映射层

• 不同业务动作映射到不同库存口径变化
• 避免业务方直接改字段

调整治理层

• 盘盈盘亏、人工修正、回滚都走正式调整单
• 调整要留痕和审批

跨系统协同时哪些边界最重要

• 订单占用不等于仓库已出货
• 在途库存不应继续售卖
• 盘点差异不能直接修改余额而不留流水

监控和审计建议怎么做

• 库存账实一致率
• 锁定库存滞留量
• 在途库存超时量
• 人工调整次数和金额

高频坑位复盘

1. 所有库存都混成一个 stock

• 后续锁库、调拨、盘点都会扯不清

2. 有余额没流水

• 出问题时无法知道库存为什么变了

面试里我会怎么答

如果面试官问为什么仓储库存不能只用一个 stock 字段，我会先讲订单占用、调拨在途、盘点调整这些业务口径，再讲余额表和流水表的分层，以及所有库存变化都通过账本动作来落地。

结语

库存账本的核心价值，不是多几个字段，而是让每一笔库存变化都能被解释。

想继续看哪块，评论区留个 1 或 2 就行：

• 1 库存流水设计
• 2 锁定库存释放