发生了什么

门店有一个“代客下单”的功能:顾客到店后,由门店工作人员在商户端替顾客录入订单,代替顾客自己操作。一笔订单成交后进入“使用中”状态,表示这单已经生效、顾客开始使用;同一笔业务只应产生一条订单记录。

正常流程是:工作人员在商户端填好顾客信息和要办的事,点提交,页面把创建请求发给订单程序;订单程序生成一个订单号、写入一条订单记录,把状态置为“使用中”,再把订单返回给页面。

这一次,门店只录入了一笔代客下单,系统里却出现了两条“使用中”的订单。两条都在列表里,都是使用中,门店看到的是同一个顾客、同一笔业务办了两遍。

排查确认,问题出在创建订单这一步:页面侧没有做防抖,提交入口在被点中后不会立刻锁住,请求还没回来之前还能再发一次同样的创建请求;订单程序侧也没有做过滤,收到请求就新建一条订单、生成一个新的订单号,不检查这个门店是不是刚刚为同一个顾客建过同一笔业务。两边都没有拦住第二次,第二条订单就跟着第一条一起建了出来。

记录没有写清第一次请求为什么会被再发一次——是点按重复,还是页面等不到返回又发了一遍;能确认的是创建请求不止到达一次,前后端都没拦住后面的那一次。这两条订单后来有没有被使用、是否作废或合并,记录也没有结论。

本质

一句话:同一笔代客下单的创建请求到了两次,而创建订单的两侧都没有把第二次认成同一笔,于是各建了一条订单。

  1. 原流程。页面收一次提交,订单程序新建一条订单记录,生成一个订单号,状态置为“使用中”,返回订单号。这里的订单号是这次创建产生的结果,不是这次业务的标识——它在落库时才生成,第二次请求到达时,程序手上没有能和第一次对上号的东西。
  2. 页面侧少了什么。提交按钮被点中后没有立即置为不可点,也没有“正在创建”的提示;请求尚未返回,同一个入口还能再触发一次提交。防抖要挡的正是这个窗口。
  3. 订单程序侧少了什么。创建接口收到请求就执行“生成订单号、插入订单、改状态”,既不校验请求里有没有重复的提交标识,也不按门店、顾客、业务这类条件查一下刚刚是否已经建过,更没有唯一约束兜底。对程序来说,两次请求就是两笔互不相干的新业务。
  4. 为什么得到这个结果。两次请求各自走完整个创建流程,各自生成订单号、各插一条记录、各自把状态置为“使用中”。两条订单都完整、都合法,从系统视角看都是有效订单,所以页面上同时出现两条使用中。这不是一条记录被改坏了,而是同一次业务被执行了两遍。
  5. 处理状态。记录给出的处理只有“已修复”,没有写具体改法,也没写多出来的订单是否清理,因此修复是否包含前端锁定、后端判重或唯一索引,无法确认。

如果“已修复”只补了页面上的按钮锁定,换个入口、弱网重发或超时重发照样能建出第二条订单;防重复必须落在创建接口自己身上。

修复方向是:页面在提交后立刻锁住入口并给出“创建中”,这层只算体验拦截;创建接口按一个页面在打开表单时生成、重复提交会重复带上的提交令牌判重,同一令牌只建一条订单,并给令牌加唯一索引兜住并发;两次请求同时到达时,后到的那次查出已建的订单直接返回,不再插一条。

下面的 Java 代码为脱敏教学示例,用于说明“创建接口每次都新建、没有可用的判重依据”与改法,不代表实际项目源码或已上线实现;令牌有效期与字段名为示意。

错误代码

// 代客下单创建接口(脱敏教学示例)
@PostMapping("/station/order/agent-create")
public Result<OrderVO> agentCreate(@RequestBody AgentOrderReq req) {
    // 为什么错:订单号在落库时才生成,第二次请求拿不到任何能与第一次对上号的标识
    String orderNo = orderNoGenerator.next();
    StationOrder order = new StationOrder();
    order.setOrderNo(orderNo);
    order.setStationId(req.getStationId());
    order.setCustomerMobile(req.getMobile());
    order.setItemId(req.getItemId());
    // 为什么错:不管之前建没建过,收到请求就把状态置为使用中
    order.setStatus(OrderStatus.IN_USE);
    // 为什么错:拿本次刚生成的订单号去查重,永远查不到,判重形同虚设
    if (orderMapper.existsByOrderNo(orderNo)) {
        throw new BizException("订单已存在");
    }
    orderMapper.insert(order);
    return Result.ok(toVO(order));
}

修复代码示例

// 修复:提交令牌判重 + 唯一索引兜底(脱敏教学示例)
@PostMapping("/station/order/agent-create")
public Result<OrderVO> agentCreate(@RequestBody AgentOrderReq req) {
    String token = req.getSubmitToken();   // 页面打开表单时生成,重复提交沿用同一个
    // 修复:同一令牌正在创建时直接拦住,不再往下建单
    if (!submitTokenService.tryLock(token, Duration.ofMinutes(5))) {
        throw new BizException("订单正在创建,请勿重复提交");
    }
    // 修复:先按令牌查一次,已经建过就把原来那条返回给页面
    StationOrder exist = orderMapper.selectBySubmitToken(token);
    if (exist != null) {
        return Result.ok(toVO(exist));
    }
    StationOrder order = buildOrder(req);
    try {
        orderMapper.insert(order);       // 表上对 submit_token 建唯一索引,兜住并发
        return Result.ok(toVO(order));
    } catch (DuplicateKeyException e) {
        // 修复:两个请求同时到达时,后到的这条读到先落库的那条,不再新建
        return Result.ok(toVO(orderMapper.selectBySubmitToken(token)));
    }
}

两段代码改的是同一处:错误版每次请求都新生成订单号并直接插入,判重条件用的是本次新生成的号码;修复版把请求自带、重复提交时不变的提交令牌作为判重依据,先查再插,并用唯一索引保证并发时也只落一条。

下次遇到这些场景要警惕

  • 给创建类动作加防重复时:先问清拦截装在哪一层。只锁按钮属于体验层,换入口、弱网重发、脚本重放都能绕过去;检查方式是对同一笔业务连发两次创建请求,看库里是不是只有一条。
  • 选判重依据时:拿落库时才生成的订单号、流水号去查重等于没查,因为重复请求每次都会拿到新号码。要选请求发出前就已确定、重复提交时会重复带上的东西,比如页面生成的提交令牌或业务单号,拿它查重并加唯一索引。
  • 同一笔业务出现多条记录时:先分清是一条记录被改了两次,还是同一次业务执行了两遍。本例两条都是使用中,说明两次都跑完了整个创建流程,问题在入口判重,不在状态流转。
  • 只看到“已修复”三个字时:确认修复覆盖了前端入口和后端接口,以及多出来的历史数据怎么处理;只改页面不改接口,等于把问题留给下一次重发。