发生了什么
平台上的商户分两级:一级商户直接与平台合作,二级商户挂在一级商户名下,由一级商户带进来做业务。商户的名称、联系人这类资料由商户自己在“商家资料页”维护,保存后写进商户主档——主档是全平台判断这家商户叫什么、归谁管的那份记录。
名称不只存在主档里。平台内部还有两个后台会展示商户名称:合作方管理页拿来核对合作方以及它的实名信息(实名是合作方在平台登记的证件姓名),企业客户后台的用户列表拿来按商户归档用户。这两处各自也存了一份商户名称,页面打开时直接读自己那份。正常改名的结果是:主档更新后,这两份名称副本一起刷新,三个地方显示同一个新名称。
这次一位商户最初提报的名称写错了,在商家资料页里改了名。合作方管理页的名称跟着变成了新名称,企业客户后台里这家商户的名称仍是旧的。二级商户的情况更少:改名后合作方管理页只更新了实名那一栏,合作方名称本身没有变,企业客户后台的名称也没有变。
反馈人还提到,改名之后,原本属于另一家商户的一批用户被挂到了改名后的这家商户名下。记录没有写用户归属是按商户名称还是别的字段关联的,也没有说明这一步和名称同步是不是同一条路径造成的,原因待核实,这里不把它当作结论。
处置写了三步:先订正已经错的数据,再让改名同步不再区分一级、二级商户,最后修企业客户后台那条同步逻辑。记录没有写订正覆盖了多少条数据、是否已经全部回填,也没有写同步逻辑的修复是否上线验证过,所以不能当成已经修好。
本质
- 名称被复制成了多份。改名要动的不是一个字段,而是主档加两处副本;哪一处没被点名,它就一直是旧值,而页面读的正是自己那份副本。
- 同步逻辑按商户层级分支。同一段改名代码里,一级商户走的分支会把新名称抄给合作方管理页;二级商户走另一条分支,那条分支只给实名字段赋了值,名称字段没有赋值。所以二级商户改名后,合作方页上的名称不变,只有实名变了。这不是少跑了一次同步,而是这条分支本来就不写名称。
- 企业客户后台这条路径没有接上。改名流程里没有调用它,一级商户和二级商户都一样,它那份名称始终停在第一次写入的值,商户改几次名都不会变。
- 三处数据不一致之后,没有对账也没有告警,只能等使用的人按名称核对、发现对不上才知道。
- 订正数据只处理已经错的那一批。同步路径不补齐,下一家商户改名还会留下同样的旧名称;所以补路径和订正数据要一起做。
商户名称在主档和两个后台各存一份,改名只刷新被点名的副本,页面读哪份就显示哪份的旧值。
修复方向是:改名时先列出所有保存了商户名称的模块,按清单逐个同步,不按商户层级跳过任何一处;同步按商户编号定位记录,不按名称匹配;同步失败留下可重试的任务并告警,再加一层定时对账,主档与副本名称不一致就补同步、报出来。存量数据在同步路径补齐之后统一回填一次。
以下两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
public class MerchantRenameService {
private final MerchantRepository merchantRepo;
private final PartnerClient partnerClient; // 合作方管理页
private final EnterpriseClient enterpriseClient; // 企业客户后台,改名时从未被调用
public void rename(long merchantId, String newName) {
Merchant merchant = merchantRepo.get(merchantId);
merchant.setName(newName);
merchantRepo.update(merchant); // 主档改了,两处副本靠下面的同步各自再抄一份
if (merchant.getLevel() == Level.FIRST) {
partnerClient.updateName(merchantId, newName);
} else {
// 为什么错:二级商户走这个分支,只同步实名,名称字段没有赋值
partnerClient.updateRealName(merchantId, merchant.getOwnerRealName());
}
// 为什么错:企业客户后台的同步调用不在这里,一级、二级商户都不会更新它的名称
}
}
修复代码示例
public class MerchantRenameService {
private final MerchantRepository merchantRepo;
private final List<NameSubscriber> subscribers; // 每个存了名称副本的模块各注册一个
private final RenameTaskRepository taskRepo;
@Transactional
public void rename(long merchantId, String newName) {
Merchant merchant = merchantRepo.get(merchantId);
merchant.setName(newName);
merchantRepo.update(merchant);
// 修复:每个模块的同步都落成任务,清单里既有合作方页也有企业客户后台
for (NameSubscriber subscriber : subscribers) {
taskRepo.save(new RenameTask(merchantId, subscriber.target(), newName));
}
}
public void dispatch(long taskId) { // 修复:不区分一级、二级,统一按商户编号推名称
RenameTask task = taskRepo.find(taskId);
subscribers.select(task.getTarget())
.updateName(task.getMerchantId(), task.getNewName());
taskRepo.markDone(taskId); // 失败不标记完成,留待重试
}
}
下次遇到这些场景要警惕
- 改商户名称、简称、联系人这类会被多个后台展示的字段时:先把所有存了这份字段的模块和页面列出来,改一次名之后逐个页面打开核对,确认每处都是新值,而不是只看发起修改的那个页面。
- 同一段代码按商户层级(一级、二级)走不同分支时:两个层级各造一条数据跑完整流程,比对两条分支更新的字段清单,特别留意“名称”和“实名”这类相邻字段有没有在某一条分支里被漏掉。
- 新做一个要展示商户名称的后台模块时:先确认它读的是主档还是自己那份副本;如果是副本,必须在改名流程里给它加上同步入口,否则它会一直停在首次写入的值。
- 发现主档和页面不一致时:先确认哪一侧是旧数据、影响了多少商户,再订正;订正完把同步入口补齐并加对账,否则下一批数据还会错。