发生了什么
企业客户要买套餐,先要在商户资料里建一个商户。每个商户有一个商户编号,这是主键,不会重复;商户还有名称和所在城市,一级商户下面可以再挂二级商户。系统会为商户生成一条渠道记录,渠道是这套业务里的归属对象:用户登记在哪个商户名下,就挂到那个商户对应的渠道上;用户能买哪些套餐,也是按这条渠道判断的。渠道编号由系统按固定规则拼出来,用户归属、套餐范围这些数据都拿这个编号去关联。
正常情况是一个商户对应一条渠道,渠道编号唯一。运营在企业用户名单里把用户录到某个商户名下,系统按这个商户找到它的渠道,把用户挂上去;用户打开购买页,就能看到这个渠道开放的套餐并下单。
这次建了两个商户,名称完全相同,城市也相同,只有商户编号不一样。系统给商户生成渠道时,渠道名称按“城市名称加商户名称”拼,渠道编号再由这个名称算出来。两个商户的城市和名称都一样,算出的渠道编号自然也一样。第二个商户生成渠道时,程序先按编号去查,查到已经有一条就直接把这条返回,既没有新建,也没有比对这条渠道挂的是哪个商户编号。于是两个商户共用了一条渠道记录,同一个渠道编号对应了两个商户编号。
运营随后把用户录到第二个商户名下。系统按商户取渠道,取到的还是那条被共用的渠道,用户归属里写下的渠道编号和第一个同名商户的用户完全一样。用户打开购买页,系统按这个渠道判断他能买哪些套餐,命中的不是他实际所属的商户,页面提示买不了套餐。
本质
问题出在渠道编号的生成规则:拿一个业务上允许重复的字段,派生出一个被当成唯一键使用的编号。
- 商户资料程序建商户时写入商户编号、名称和城市。名称只要求人能看懂,没有要求全局唯一,所以两家不同商户可以同名。
- 生成渠道时,渠道名称等于城市加商户名称,渠道编号再从名称算出来。规则里没有商户编号参与。两家商户只要城市和名称相同,算出的渠道编号必然相同。
- 渠道生成代码先按编号查一次,查到就认为“这个商户的渠道已经存在”,直接把已有记录返回。它没有比对记录里的商户编号,插入前也没有再做一次冲突判断,所以冲突不会暴露出来,只会静默复用。
- 用户登记到第二个商户名下时,归属写入的是渠道编号。取到的渠道是第一条,写下的编号也就和第一个商户的用户一样。两个商户的用户从此混在一条渠道里,谁属于谁只能另找字段区分。
- 购买页按渠道判断套餐范围,命中的是这条被两家共用的渠道,用户的归属和实际商户对不上,于是显示买不了套餐。
真正唯一的商户编号没有参与编号生成,两个不同商户被算成了同一条渠道。
修复方向是:把商户编号加进渠道名称的生成规则,一级渠道的名称改成“城市名称-一级商户名称-商户编号”,二级渠道再带上二级商户编号;渠道编号随名称一起变化,同名商户就各得一条渠道。命中已有编号时,代码还要比对渠道挂的商户编号,不一致就报错,不再静默复用。记录里另有一项待确认:不同商户编号是否允许同名,这条要由业务方给结论。这决定了规则是只在编号上区分,还是连展示名称也要一起区分。已经并到一条渠道上的存量商户需要单独核对,不能只改生成规则。修复的上线与验证状态待确认。
下面的 Java 代码为脱敏教学示例,用于说明“编号由可重复的名称派生,同名商户撞成一条渠道”的机制与改法,不代表实际项目源码或已上线实现。
错误代码
// 渠道生成:渠道名称按“城市-商户名称”拼,编号由名称算出(示意)
public Channel ensureChannel(Merchant merchant) {
String channelName = merchant.getCity() + "-" + merchant.getName();
// 为什么错:编号由名称派生,而名称允许重复,两家同名商户会算出同一个编号
String channelId = md5(channelName);
Channel exist = channelDao.selectByChannelId(channelId);
if (exist != null) {
// 为什么错:查到编号就直接复用,没有比对渠道挂的商户编号,
// 第二个同名商户被并进了第一个商户的渠道
return exist;
}
Channel channel = new Channel(channelId, channelName, merchant.getId());
// 为什么错:插入前没有再判断一次冲突,编号撞了也不会暴露
channelDao.insert(channel);
return channel;
}
// 用户登记:按商户取渠道,把渠道编号写进用户归属
public void bindUser(long userId, long merchantId) {
Merchant m = merchantDao.selectById(merchantId);
Channel c = ensureChannel(m);
// 为什么错:渠道是共用的,用户归属跟着错挂到第一个同名商户
userDao.updateChannel(userId, c.getChannelId());
}
修复代码示例
public Channel ensureChannel(Merchant merchant) {
// 修复:渠道名称规则加入商户编号,同名商户不再算出同一个名称
String channelName = merchant.getCity() + "-" + merchant.getName()
+ "(" + merchant.getId() + ")";
// 编号随名称一起变化,唯一性来自商户编号,不再只看名称
String channelId = md5(channelName);
Channel exist = channelDao.selectByChannelId(channelId);
if (exist == null) {
channelDao.insert(new Channel(channelId, channelName, merchant.getId()));
return channelDao.selectByChannelId(channelId);
}
// 修复:命中已有渠道时比对商户编号,不一致就报错,不再静默复用
if (exist.getMerchantId() != merchant.getId()) {
throw new BizException("渠道编号冲突,需人工核对:" + channelId);
}
return exist;
}
public void bindUser(long userId, long merchantId) {
Merchant m = merchantDao.selectById(merchantId);
// 渠道已经按商户唯一,用户归属写下的编号能对回实际商户
userDao.updateChannel(userId, ensureChannel(m).getChannelId());
}
下次遇到这些场景要警惕
- 用名称、城市、地址拼编号或编码时:先列出这些字段在业务上是否允许重复,允许重复的就不能单独当唯一键;构造两条只有主键不同、名称完全相同的数据各跑一次,观察是否得到两个不同的编号。
- 给已有对象新增派生标识时(渠道、账号、档案都算):检查生成代码里“查到编号已存在就复用”的分支,看它有没有比对真正的业务主键;把比对条件临时去掉再跑一遍,确认这种复用会不会把两个主体并成一个。
- 看到“同一个编号对应多个主体”的反馈时:先查这个编号的生成规则和插入处的判重条件,确认判重比的是不是主键;不要先当成用户录错或名称写错处理。
- 改生成规则准备上线时:用新规则把存量数据重算一遍编号,和现有编号比对,找出已经被并到一条渠道上的商户,先定好拆回独立渠道的处理方式,再改代码。