发生了什么

换电柜给用户换电池。用户在平台这一侧用一个手机号对应一个账号,账号名下挂着两样东西:一颗正在使用的电池(系统里有一条绑定关系,写明这颗电池归谁),和一份换电套餐(有效期内可以换电,套餐还限定了能配哪种规格的电池)。合作渠道商户有自己的一套骑手账号,渠道账号和平台账号按手机号对应。骑手在渠道那边换了手机号,渠道把这次变更同步过来,平台要把旧手机号账号名下的电池和权益迁到新手机号对应的账号上。

换电套餐分两类:一类带免时长,也就是在约定期限内换电不再单独计费;另一类不带免时长,是用户自己花钱买的普通套餐。按早先的业务约定,渠道换手机号这个场景只处理带免时长的套餐,不带免时长的套餐不参与迁移。

正常一次换号,平台先按新手机号找到或建好新账号,再结束旧账号的套餐、把旧账号名下的电池解绑、把同一颗电池绑到新账号上。三件事针对的是同一笔变更,要么都成立,要么都不做,用户才能在新手机号下继续用这颗电池。

这次不一样。用户旧账号名下是一份从外部渠道买的 64 型电池套餐,不带免时长,还在生效中;渠道这次换号,同时把账号对应的套餐换成了 48V 小电池套餐。平台的换号处理把“是否免时长”这个判断只放在了“结束旧套餐”一步上,解绑旧电池和绑定新电池照常执行,换绑前也没有核对电池规格和新套餐是否匹配。

结果是:旧账号的电池解绑成功,旧套餐没有结束;把这颗 64 型电池挂到新账号的 48V 小电池套餐下时,绑定环节按“电池型号与套餐类型不匹配”拒绝,新账号始终没有电池。用户两头都缺一块:旧账号里套餐还在、电池已经不在名下;新账号里有套餐,却挂不上这颗电池。

本质

一句话:一笔换号变更里,三个互相关联的动作只有“结束旧套餐”被“是否免时长”这个条件拦住,解绑旧电池和绑定新电池照做;换绑前没有核对电池规格,绑定被拒后也没有把已经生效的解绑退回去,于是一笔变更只做了一半。

拆开看:

  1. 正常时这三个动作同进同退。换号要把账号对应关系、电池绑定、套餐归属一起迁;判断“这份套餐要不要迁”应该放在整笔换号的入口,由它决定动不动电池和套餐。
  2. 这次的条件放在哪。程序只把“是否免时长”写成“结束旧套餐”这个分支的条件,另外两个动作没有带上同样的判断,于是结束旧套餐被跳过,解绑和绑定继续执行。
  3. 执行顺序。先解绑旧账号的电池,再判断套餐类型,不是免时长就跳过结束套餐,最后把电池绑到新账号。
  4. 绑定为什么被拒。新手机号对应的套餐是 48V 小电池,物理电池是 64 型;绑定环节要求电池型号与套餐类型匹配,不匹配就不写这条绑定关系。这颗电池按规格本来就不该挂在这个套餐下,这次写入被拒本身是对的。
  5. 为什么留下半截数据。解绑已经生效,绑定失败后没有任何补偿把解绑撤销,旧套餐也没有被结束;旧账号的套餐仍在生效,电池却不在它名下了,新账号有套餐却没有电池。

修复方向是三步:先按渠道 id 更新渠道 id 与新手机号、平台新账号的对应关系;再给新账号分配免时长权益;关闭旧套餐前先判断是不是不带免时长的套餐,如果是,整笔换号就不动旧套餐、不解绑旧电池,也不给新账号绑电池。这套改动尚未上线,上线与验证情况待确认。

判断只拦住了一步、另外两步照做,失败后又不回退,一笔变更就被拆成了两半。

下面两段代码是按这条链路写的脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名与字段名均为示意。

错误代码

/** 渠道发起更换手机号:把旧账号的电池与套餐迁到新手机号账号 */
public void changePhone(String channelId, String oldPhone, String newPhone) {
    Long oldUserId = accountService.findByPhone(oldPhone);
    Long newUserId = accountService.findOrCreateByPhone(newPhone);
    String batterySn = batteryService.getBoundBattery(oldUserId);
    Package oldPkg = packageService.getActive(oldUserId);
    Package newPkg = packageService.getActive(newUserId);

    // 为什么错:解绑不看套餐类型,先无条件执行,后面成败都不会回滚
    batteryService.unbind(oldUserId, batterySn);
    if (oldPkg.isFreeDuration()) {
        // 为什么错:免时长的判断只加在“结束旧套餐”这一步,
        // 非免时长套餐被留在这里,电池却已经解绑了
        packageService.close(oldPkg);
    }
    // 为什么错:换绑前不校验电池型号与目标套餐是否匹配,
    // 64 型电池挂到 48V 小电池套餐下被拒,失败后解绑也不撤回
    batteryService.bind(newUserId, batterySn, newPkg);
}

修复代码示例

public void changePhone(String channelId, String oldPhone, String newPhone) {
    Long oldUserId = accountService.findByPhone(oldPhone);
    Long newUserId = accountService.findOrCreateByPhone(newPhone);
    Package oldPkg = packageService.getActive(oldUserId);

    // 1. 渠道 id 与新手机号、新账号的对应关系先迁过来,这一步与电池无关
    linkService.update(channelId, newPhone, newUserId);
    // 2/3. 非免时长套餐按约定不参与换号:旧套餐、旧电池绑定、新账号绑定都不动
    if (!oldPkg.isFreeDuration()) {
        entitlementService.grantFreeDuration(newUserId);
        return;
    }
    String batterySn = batteryService.getBoundBattery(oldUserId);
    Package newPkg = packageService.getActive(newUserId);
    // 换绑前先校验,规格不符直接拒绝,此时还没有改动任何绑定
    if (!batteryService.match(newPkg, batterySn)) {
        throw new BizException("电池型号与新账号套餐不匹配,本次不做换绑");
    }
    // 解绑、结束旧套餐、绑定放在同一事务里;若其中有远端调用,需要显式补偿
    transactionTemplate.executeWithoutResult(s -> {
        packageService.close(oldPkg);
        batteryService.unbind(oldUserId, batterySn);
        batteryService.bind(newUserId, batterySn, newPkg);
    });
}

下次遇到这些场景要警惕

  1. 给已有流程加“某类数据不参与”的约定时,先把这个流程里所有会改数据的动作列全(解绑、结束、绑定、发权益),逐个确认判断加在入口还是每个动作上;只加在其中一步,就会出现半执行。
  2. 换绑电池、电柜这类物理资源前,先构造“目标账号套餐规格与资源型号不一致”的数据,确认程序在写入前拒绝,且原绑定保持不变,而不是先解绑再失败。
  3. 用一笔跨渠道的换号做回归:旧账号留着在用的非免时长套餐、新账号是小电池套餐,执行后分别检查旧套餐状态、旧账号电池绑定、新账号电池绑定三处是否都停在变更前,再核对渠道 id 与新手机号的对应关系已更新。
  4. 处理已经半执行的账号时,先确认实物电池在谁手里,再决定是恢复旧账号绑定还是改绑新账号,不要只补一边的关系。