发生了什么

企业商户可以把一批用户批量启用为自己名下的企业用户:商户提交一份手机号清单,系统逐个把用户和这家商户关联起来。关联之后,这些用户换电产生的订单就归这家商户。平台另有一套“保护期”规则:用户在某家商户领过免时长(免费换电的时长),系统会在用户档案上记一条保护期,写明这段保护期属于哪家商户;保护期内用户下单,订单不按当前实际服务的商户重新判断,而是照档案上的记录算给那家商户。这条规则是为了保护先给用户发免时长的商户,避免用户被别家拉走之后,前面投入的免时长白花。

正常情况有两条路径都能把归属改过来。第一条是批量启用:程序逐个查用户档案,如果这个用户身上记着其他商户的保护期,就打破它,把用户改到当前商户名下,再按当前商户重建保护期。第二条是购买套餐:用户不管有没有旧保护期,只要买了某家商户的套餐,这笔订单就归这家商户,同时按这家商户建立新的保护期。

这次的用户先在一家商户领了免时长,档案上有了这家的保护期;过了一段时间,他被另一家商户批量加成了企业用户,随后下单,订单还是算给了最早那家商户。业务在后台看到的订单归属,和实际给他提供服务的商户对不上,同一时期记到两起客诉。核对后还发现出问题的不是这一笔:修复之前生成的历史订单,归属同样停在旧商户上。

本质

一句话:两条本该改归属的路径都没有改,用户档案上的旧保护期一直有效,下单时照着档案算,订单就落在旧商户名下。

  1. 批量启用时,程序没有给每个用户各判断一次“要不要打破保护期”。它把单个用户的结论当成了整批的结论:按手机号顺序处理,一旦碰到一个不需要打破的用户,比如身上没有别的商户的保护期,这一批的处理就到此为止。排在后面、确实有别的商户保护期的用户,也没有再走到打破那一步。
  2. 购买套餐时,另一条路径也漏了重新归属。用户买了新商户的套餐,订单本该归新商户并建立新保护期,但当时那一版没有把档案上的归属改过去。
  3. 下单时,订单归属只读用户档案上的保护期。两条路径都没有把档案改掉,档案上记的仍是最早那家商户,订单便继续算给它。

两处缺陷在不同时期引入:批量启用这一条在 2024 年初引入,购买套餐这一条在 2022 年就有了。两者都让“打破旧保护期”落空,叠在一起,历史订单的归属就长期停在旧商户。批量启用这一条已经修复,购买套餐这一条在 2025 年 11 月底修复;修复后新建订单的归属已经正确,但修复之前已经生成的订单不会自己回正,仍要单独核对订正。

两个独立缺陷都通向同一件事:用户换了商户,档案上的保护期却没有哪一步负责改;只要有一条路径漏改,订单归属就会一直错下去。

下面两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 批量启用:商户提交一批用户,程序按手机号顺序挂到当前商户名下
void enableUsers(List<Long> userIds, long merchantId) {
    for (Long userId : userIds) {
        Protection p = protectionMapper.findByUserId(userId);
        if (p == null || p.getMerchantId() == merchantId) {
            // 为什么错:这个用户不用打破,被当成整批都不用打破,
            // 直接结束循环,排在后面、确实需要打破的用户全被跳过
            return;
        }
        protectionMapper.close(p.getId());          // 关掉旧保护期
        userMapper.updateMerchant(userId, merchantId);
        protectionMapper.open(userId, merchantId);  // 按当前商户重建
    }
}

修复代码示例

// 修复后:每个用户各判断一次,只跳过“当前这一个”用户要跳的步骤
void enableUsers(List<Long> userIds, long merchantId) {
    for (Long userId : userIds) {
        Protection p = protectionMapper.findByUserId(userId);
        if (p != null && p.getMerchantId() != merchantId) {
            protectionMapper.close(p.getId());   // 只关这一个用户的旧保护期
        }
        // 无论原来有没有保护期,都把归属改到当前商户
        userMapper.updateMerchant(userId, merchantId);
        // 已有当前商户的保护期就保留,没有才新建,避免重复
        protectionMapper.openIfAbsent(userId, merchantId);
    }
}

购买套餐那条路径的修复不在上面的示例里。按正常规则,用户付款成功后要先把档案归属改成这家商户,再按这家商户建立保护期。两处修复都只对之后新生成的订单生效,修复前的订单仍按旧归属存在库里,需要另做核对和订正。

下次遇到这些场景要警惕

  • 批处理循环里出现 return、break 或整批共用的标记:构造一批混合数据,前一个用户不需要处理、后一个用户需要处理,跑完看后一个是否真的被处理,别只用一个“人人都需要处理”的批次验证。
  • 改动“用户属于哪个商户”这类档案字段:先把所有读它的地方列出来,包括下单归属、结算和报表,逐处确认改动之后结果跟着变;只在批量启用里改,购买套餐那条路仍会漏。
  • 上线“打破保护期”这类修复之后:取修复前一段时间的订单,筛出“保护期商户与当前归属商户不一致”的记录抽查,别默认修复会自动覆盖存量订单。
  • 同一用户先后被多家商户认领(发免时长、加企业用户、买套餐):按用户查一次档案,比对保护期商户、归属商户和最近一笔订单的商户是否一致,三者不一致就是归属已经错位。