发生了什么

门店仓库是门店自己管的一小份库存:商品卖出去一件,仓库数量就减一件,账和实物要对得上。顾客到店买东西时,店员可以在系统里做“代客下单”——扫顾客在第三方平台买好的团购券,由系统替顾客下单、核销这张券、扣掉门店仓的一件库存,再生成一张待核销工单。工单是门店后续履约、出库的凭据。一笔正常的代客下单,结果是:一张券对应一笔订单、一张工单,门店仓少一件商品,页面上能看到这笔单。

这次的门店刚在第三方平台开张,系统里还没有对应的门店授权。8 月 6 日晚上,店员拿着同一张顾客券连续提交了五次,五次都返回同一个失败结果,提示门店未授权。页面上没有订单,也没有工单,看起来像是“什么都没发生”。

库存不是这样。每一次提交,系统都是先从门店仓扣掉一件商品,再去核销券;核销报错,前面那次扣减已经留了下来。五次之后,门店仓少了五件,订单是零笔,工单没有留下,顾客那张券也没有被核销,门店这边查不到这次提交发生过。日常页面不会显示这五件商品去了哪里,只有翻库存流水才能看到五次扣减;而库存侧当时只有扣减接口,没有对应的回库接口。

本质

这笔业务里有四个东西:订单(顾客买了什么)、工单(门店要履约的那张任务单)、券(顾客在第三方平台的购买凭证)、门店仓库存(这件商品还剩几件可卖)。正常顺序是先确认门店有资格接这张券,再建单、核销券、扣库存;中间任何一步失败,都不该留下前面步骤的结果。

问题有两层,叠在同一次提交里。第一层是判重失效。旧的代客下单把工单建在扣减之前,工单号就是这次业务的唯一编号,用过之后会入库留存,重复提交能认出是同一笔。今年 4 月门店仓上线,扣减侧沿用了“按业务编号判重、同一个编号只扣一次”的做法;5 月,两条各自演进的链路在这里汇合,建工单、扣库存、核销券被合成一次提交,而新的实现每次提交都会新建一张工单、生成一个新的业务编号,这个编号又没有入库留存,判重时查不到,同一张券的五次提交被当成了五笔互不相干的新业务。第二层是顺序不对,扣减排在了核销前面。单次提交里的顺序是这样的:

  1. 事务外先校验库存够不够,通过。
  2. 开启本地事务,写入工单、更新工单状态。
  3. 中途调用库存服务扣掉一件。这是一次跨服务调用,扣减在对方那边提交之后就是既成事实。
  4. 紧接着调用第三方核销券,对方返回“当前门店未授权”,抛出异常。
  5. 本地事务回滚,工单的写入和状态更新一起被撤销。

本地事务只能撤销自己库里那几张表,撤不掉已经提交到库存服务的扣减。于是每一次失败的提交,都精确地留下“库存减一、订单和工单都不存在”这个组合,而扣减请求里的业务编号每次都是新的,五次就是五条互不相干的扣减记录。已经扣掉的库存没有回库接口可以退回,只能人工盘点。

判重键随每次提交在变,同一张券被当成五笔新业务;每笔又都在核销失败前扣掉一件,库存就这么少了五件。

这条链路已经重构:先创建用户订单,再核销外部券、完成支付,然后建待核销工单,最后内部核销出库,把不可回滚的扣减挪到了核销成功之后;8 月 13 日提测、8 月 20 日上线。重构上线后的实际验证结果尚未确认。

下面的 Java 代码为脱敏教学示例,用于解释“远程扣减先于校验执行、每次提交又换新编号”的机制与改法,不代表实际项目源码或已上线实现。

错误代码

@Transactional
public PlaceResult submitPlaceTicket(PlaceRequest req) {
    // 为什么错:每次提交都新建工单、新生成业务编号,
    // 同一张券重复提交,在扣减侧看来是五笔不同业务
    String ticketNo = idGenerator.next();
    String bizId = "BIZ" + idGenerator.next();
    ticketDao.insert(ticketNo, req);
    ticketDao.updateStatus(ticketNo, TicketStatus.CREATED);

    // 为什么错:跨服务扣减先执行,成功即落库,本地事务回滚带不走它
    inventoryClient.deduct(req.getStoreId(), req.getSkuId(), bizId);

    // 为什么错:核销排在扣减之后,这里抛错时库存已经扣掉
    thirdPartyClient.writeOff(req.getCouponNo(), req.getStoreId());
    ticketDao.finish(ticketNo);
    return PlaceResult.ok(ticketNo);
}

修复代码示例

public PlaceResult submitPlaceTicket(PlaceRequest req) {
    // 业务键用「门店 + 券号」:同一张券重复提交命中同一条记录
    String bizKey = req.getStoreId() + ":" + req.getCouponNo();
    PlaceRecord exist = placeRecordDao.findByBizKey(bizKey);
    if (exist != null) {
        return PlaceResult.of(exist);   // 重复提交直接返回上次结果,不再往后走
    }
    // 调整顺序后的四步:先建单,再核销券,最后才扣库存
    orderService.createUserOrder(bizKey, req);
    thirdPartyClient.writeOff(req.getCouponNo(), req.getStoreId());
    ticketService.createPendingTicket(bizKey, req);
    try {
        inventoryClient.deduct(req.getStoreId(), req.getSkuId(), bizKey);
    } catch (Exception e) {
        // 扣减失败或结果未知:工单撤销,这次核销标记为待回退,不留静默差异
        ticketService.cancel(bizKey);
        writeOffCompensation.markPending(bizKey);
        throw e;
    }
    ticketService.finish(bizKey);
    return PlaceResult.ok(bizKey);
}

业务键在记录表上要有唯一索引,先查后插才挡得住并发一起提交;核销成功但扣减失败时,必须留下可追踪的待回退记录,因为回滚仍然带不走已经提交的远程动作。

下次遇到这些场景要警惕

  1. 一个本地事务里夹着远程扣减、占用额度、发券这类调用时,把后面的步骤人为改成抛异常,跑一次,再去对方系统查这笔操作是否已经落库、有没有对应的回退动作,不要只看本地事务有没有回滚。
  2. 把多步流程合并成一次提交时,先把原来用于判重的编号列出来,确认新流程每次提交是否还生成同一个编号;用同一张券、同一个外部单号连续提交两次,看是新增一条记录还是命中已有记录。
  3. 副作用依赖外部校验(门店授权、验券、风控)通过才该发生时,用未授权的门店或账号走一遍,检查库存、额度、券状态是否被提前改动。
  4. 只有扣减接口、没有回库接口的资源,上线前先定好异常路径怎么补偿,并按“已扣减但没有对应单据”跑一次对账,确认这类差异能被发现和追回。