TITLE: 商品自提库存监控:只推“新出现”的货 EXCERPT: 定时查门店自提库存时,接口状态会在几分钟内反复翻转。正确做法是持久化每个 slot 的上一轮状态,只在“无货→有货”时推送,并在无货时清空时间字段。 TAGS: 库存监控, 定时任务, 状态机, Python

用脚本盯门店自提库存,常遇到反直觉现象:十分钟前接口返回“有货”,再跑一次全变“无货”。接口没报错,变的是库存本身。

什么情况下会撞上它

典型场景:定时任务每 15 分钟查一次某商品各门店自提库存。某轮查到某门店某规格有货并推送通知;几分钟后手动再跑,8 家门店全部返回不可购买,状态码正常。若脚本“查到有货就推”,会导致同一批货反复推送,或货已被抢完脚本还在报旧状态。

为什么会这样

到店取货库存是动态值。某门店“可自提”数量取决于实时库存、线上订单锁定和临时释放。有人下单立刻锁一件,订单取消或超时未支付又释放回来。同一个 slot(商品 + 门店 + 规格)几分钟内从 available 翻成 unavailable 再翻回来,是正常现象。监控目标不是“记录当前有没有货”,而是“判断这次有货是不是新出现的”。

怎么做:把状态存下来,只推“新出现”

维护一份状态文件,给每个 slot 记录上一次观察到的状态和推送时间。每轮查询后:

  1. 本轮有货、上一轮无货 → 新出现,推送,记下 first_available 和 last_notified。
  2. 本轮有货、上一轮也有货 → 持续有货,不重复推送。
  3. 本轮无货 → 把 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 分钟一轮能覆盖大部分补货,但热门商品可能在两轮之间被抢完;频率越高越及时,也越容易触发接口限流。无货时保持安静是刻意设计:只在“新出现”时推送,避免把动态库存的每次抖动都变成一条通知。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注