发生了什么

平台上的商户分两级:一级商发展二级商,二级商直接面对顾客。每个商户在系统里对应一条“渠道”记录,渠道有一个由系统拼出来的名字,规则固定为“城市名称 + 一级商名称 + 二级商名称”,拼完超过 36 个字符就截掉后面的部分。一级商给名下二级商买套餐时,会扫二级商的二维码下单,这笔套餐订单要记下归属哪条渠道。

正常情况很直观:扫的是哪家二级商的码,订单就归属到那家二级商自己的渠道,后续按渠道看销量、配置活动都以这条记录为准。

这次不同。同一位一级商扫名下几个不同二级商的码买套餐,订单归属却全部落到了同一条渠道上,那是同一座城市里另一家商户的渠道。也就是说,同一级商下几个不同的二级商,在系统眼里变成了同一个。反馈来自商户侧,确认的现象是套餐订单归属错了;具体涉及多少笔订单、多少金额,现有记录没有给出数字。

本质

  1. 生成渠道名称的程序按固定规则拼接字符串,然后无条件截断到 36 位。这个长度限制来自渠道名称字段,当时没有为“截断后仍要区分”留任何补偿。
  2. 这位一级商的名称很长,城市名称加上一级商名称已经占满了前 36 位,二级商名称整段被切掉。于是同一级商下每个二级商拼出来的名称完全一样。
  3. 渠道名称在这条链路上不只是展示文字,还被当成查找渠道的依据。字符串一样,程序就认为它们是同一条渠道,几条不同的渠道记录在归属时被并成了一条。
  4. 结果就是:一级商扫的不管是哪家二级商的码,订单都记到同一条渠道上,渠道归属和按渠道统计的销售数据一起错。

名称本来只是给人看的标签,一旦被拿来当唯一标识,截断就等于把两个不同主体合并成一个。

处理上有临时和后续两部分。临时做法是修改那位一级商的名称,让拼接结果在 36 位以内仍有区分度;改完后把错的渠道名称作废(需要放在低峰期),再让各二级商渠道重新生成,最后按新渠道重新配置营销活动。修复方向是放宽渠道名称长度限制,并调整生成策略,避免再产生会被截断的长名称。这些是处理方案,是否已经全部上线并验证,记录里没有结论。

错误代码

// 渠道名称 = 城市 + 一级商 + 二级商,超过 36 位直接截断
public String buildChannelName(String city, String firstAgent, String secondAgent) {
    String raw = city + firstAgent + secondAgent;
    // 为什么错:按固定长度截断,二级商名称整段被切掉,
    // 同一级商下所有二级商得到完全相同的名称
    return raw.length() > 36 ? raw.substring(0, 36) : raw;
}

// 为什么错:用这个名称去找渠道,重名时永远命中同一条记录
public void attributeOrder(Order order, String city, String firstAgent, String secondAgent) {
    String name = buildChannelName(city, firstAgent, secondAgent);
    Channel channel = channelMapper.selectByName(name);
    order.setChannelId(channel.getId());
    orderMapper.updateChannel(order);
}

修复代码示例

// 名称只负责展示;需要区分渠道时保留可判别信息,不靠截断
public String buildChannelName(String city, String firstAgent,
                               String secondAgent, String secondAgentNo) {
    String raw = city + firstAgent + secondAgent;
    if (raw.length() <= 36) {
        return raw;
    }
    // 截断后追加由二级商编号派生的短码(示意),同名不同渠道可以区分
    return raw.substring(0, 28) + "-" + shortCode(secondAgentNo);
}

// 归属用不可变的业务编号匹配,不用展示名称
public void attributeOrder(Order order, String secondAgentNo) {
    Channel channel = channelMapper.selectByAgentNo(secondAgentNo);
    order.setChannelId(channel.getId());
    orderMapper.updateChannel(order);
}

下次遇到这些场景要警惕

  • 把多个字段拼成一个名字当标识用之前,先量出每个字段的最长长度,构造两个只差后半段的名称,跑一遍生成逻辑,看结果是否仍然互不相同。
  • 调整字段长度限制(收紧或放宽)时,用存量最长的名称做一次全量重算,比对重算前后的渠道数量和名称是否一一对应。
  • 检查所有“按名称查记录”的调用,能换成不可变编号的一律换掉;确实要继续用名称的,加唯一性校验,发现重复就报错而不是取第一条。
  • 处理存量重名渠道时,先确认哪些订单已经归属错了,再作废旧渠道、重建并同步下游按渠道配置的活动,不能只改名称不回头对账。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。