商品自提库存监控:只推“新出现”的货
TITLE: 商品自提库存监控:只推“新出现”的货 EXCERPT: 定时查门店自提库存时,接口状态会在几分钟内反复翻转。正确做法是持久化每个 slot 的上一轮状态,只在“无货→有货”时推送,并在无货时清空时间字段。 TAGS: 库存监控, 定时任务, 状态机, Python
用脚本盯门店自提库存,常遇到反直觉现象:十分钟前接口返回“有货”,再跑一次全变“无货”。接口没报错,变的是库存本身。
什么情况下会撞上它
典型场景:定时任务每 15 分钟查一次某商品各门店自提库存。某轮查到某门店某规格有货并推送通知;几分钟后手动再跑,8 家门店全部返回不可购买,状态码正常。若脚本“查到有货就推”,会导致同一批货反复推送,或货已被抢完脚本还在报旧状态。
为什么会这样
到店取货库存是动态值。某门店“可自提”数量取决于实时库存、线上订单锁定和临时释放。有人下单立刻锁一件,订单取消或超时未支付又释放回来。同一个 slot(商品 + 门店 + 规格)几分钟内从 available 翻成 unavailable 再翻回来,是正常现象。监控目标不是“记录当前有没有货”,而是“判断这次有货是不是新出现的”。
怎么做:把状态存下来,只推“新出现”
维护一份状态文件,给每个 slot 记录上一次观察到的状态和推送时间。每轮查询后:
- 本轮有货、上一轮无货 → 新出现,推送,记下
first_available和last_notified。 - 本轮有货、上一轮也有货 → 持续有货,不重复推送。
- 本轮无货 → 把
available清回unavailable,同时清空first_available和last_notified。
第三点最关键。只写前两条、忘了无货时清状态,货没了又回来时脚本会以为“一直有货”,新一批货就漏报。
状态文件里一个 slot 大致长这样:
{
"store": "南京东路店",
"sku": "512GB 星光白色",
"available": false,
"first_available": null,
"last_notified": null
}
判定逻辑:
if now_available and not prev["available"]:
notify(slot) # 新出现,推送
slot["first_available"] = now
slot["last_notified"] = now
elif not now_available:
slot["first_available"] = None # 清空,下次重新判定
slot["last_notified"] = None
slot["available"] = now_available
顺序很重要:先判断“新出现”,再处理“无货清空”,最后更新 available。先更新 available,新出现的判断永远不成立。
怎么确认成了
跑两轮验证:第一轮有货应收到一次推送;紧接着再跑一轮,仍有货则不应再推。等货消失再跑一轮,状态文件里该 slot 的 available 应为 false,两个时间字段为 null。货再次出现时应重新收到推送。第一轮没推送,检查 available 初始值是不是 true;第二轮重复推送,检查 last_notified 有没有写进去。
边界和代价
这套逻辑假设库存接口返回实时值。若接口本身有缓存(CDN 或服务端缓存几分钟),脚本看到的“有货”可能已是旧数据,推送会滞后。查询频率也要权衡:15 分钟一轮能覆盖大部分补货,但热门商品可能在两轮之间被抢完;频率越高越及时,也越容易触发接口限流。无货时保持安静是刻意设计:只在“新出现”时推送,避免把动态库存的每次抖动都变成一条通知。