发生了什么
换电业务里,网点是放电池柜的那块场地。网点由经营方租下来做换电,场地属于房东,双方要签一份租赁合同;合同上要写清房东是哪个经营主体,这个主体在商户体系里有自己的档案,档案里有编号、状态和绑定的手机号。租金、发票、分润都按这份合同和这个主体走。
网点不做了,流程是先停业、把柜机全部禁用,再在后台提交关闭。提交前系统要做一道房东商户校验:合同上的房东必须在商户体系里存在、状态正常,否则不给关。这道校验的意义在于关闭会连带解约,主体对不上,后面的结算和退款就没有落点。
这次的问题网点已经走完了前半段:网点停业、柜机全部停用,实际已经撤柜。运营在后台提交关闭时,页面提示商户不存在,换个时间再提交还是同一句提示,关闭一直没提交成功。合同本身仍在有效期内,没有到期或作废。
排查时把两边数据对在一起看:合同上登记的房东商户编号,在商户档案里查得到,状态是启用中;但合同上登记的那个房东手机号,拿它去商户档案里反查,一条都命中不了。这个商户档案当前绑定的手机号,和合同上记的号不是同一个。
本质
一句话:提交关闭时,系统是拿合同上的房东手机号去商户档案里找主体,而这个手机号已经和档案上绑定的号对不上了;程序把按号查不到直接判成商户不存在,于是一个存在且启用的商户把网点关闭挡了下来。
- 原流程。合同签好时就记下了房东的商户编号,也记了联系电话。正常提交关闭时,应该用编号把主体定位出来,再看它的状态。
- 这次校验用的键不是编号。从结果倒推:编号能查到记录,手机号反查 0 命中,报错又落在商户存在性上,说明这一步是用手机号找商户的。
- 手机号这一侧变了。同一个房东在商户档案里换了绑定的手机号,也可能是签约时录进去的号和档案上的不是同一个,合同上的号没有跟着改,两边就对不上了。
- 查不到被当成了不存在。程序只判断有没有查到记录,查到 0 条就报商户不存在,没有区分“这个编号下没有主体”和“这个手机号在档案里没有登记”。
- 结果。主体明明在、状态也正常,关闭却被拦在提交环节;一线看到的是“商户不存在”,实际要改的是合同或档案上的手机号,提示和原因不在一个地方。
记录里给的处置只有一句:签约时是一个手机号,后台档案又是另一个手机号,导致拦截,交产品关注。修复方向是:关闭提交时的房东校验改用合同上已经登记的商户编号定位主体,只按编号判断存在性和状态;手机号不一致时记录差异、提示补充核对,不作为拦截条件;确实没有登记商户编号的老合同才回落到手机号,并且要把提示写清楚是合同缺编号,不是商户不存在。改动是否已经实施、是否验证过,目前没有确认。
下面两段 Java 代码是按上述机制写的脱敏教学示例,只对比校验时用哪个键定位主体,不代表实际项目源码或已上线实现。
错误代码
// 网点关闭提交时的房东商户校验(脱敏教学示例)
public void submitClose(long siteId) {
Contract contract = contractRepo.findActiveBySite(siteId);
// 为什么错:用合同上的联系电话去商户档案里反查主体,
// 手机号是会被换绑的联系方式,不是稳定的主体标识
String landlordPhone = contract.getLandlordPhone();
Merchant merchant = merchantRepo.queryByPhone(landlordPhone);
// 为什么错:查不到就报“商户不存在”,
// 把“这个号没登记”和“这个商户不存在”说成了同一件事
if (merchant == null) {
throw new BizException("商户不存在,无法提交关闭");
}
if (!Status.EFFECTIVE.equals(merchant.getStatus())) {
throw new BizException("商户状态异常,无法提交关闭");
}
closeService.submit(contract);
}
修复代码示例
// 修复:改用合同上已登记的房东商户编号定位主体(脱敏教学示例)
public void submitClose(long siteId) {
Contract contract = contractRepo.findActiveBySite(siteId);
String merchantId = contract.getLandlordMerchantId();
if (StringUtils.isBlank(merchantId)) {
// 修复:只有确实没登记编号的老合同才回落到手机号,
// 并且查不到时报“合同缺编号”,不再报“商户不存在”
Merchant byPhone = merchantRepo.queryByPhone(contract.getLandlordPhone());
if (byPhone == null) {
throw new BizException("合同未登记房东商户编号,请先补充");
}
merchantId = byPhone.getId();
}
Merchant merchant = merchantRepo.queryById(merchantId); // 按编号定位主体
if (merchant == null) {
throw new BizException("房东商户不存在,请核对合同");
}
if (!Status.EFFECTIVE.equals(merchant.getStatus())) {
throw new BizException("商户状态异常,无法提交关闭");
}
if (!Objects.equals(merchant.getPhone(), contract.getLandlordPhone())) {
// 修复:手机号不一致只是联系信息差异,记录待核对,不阻断解约
warnService.recordPhoneMismatch(contract.getId(), merchantId);
}
closeService.submit(contract);
}
改动只落在提交关闭这一处校验。如果签约、续签等其他入口也按手机号反查主体,同样的不一致会在那些地方再出现,记录里没有说明是否一并排查过。
下次遇到这些场景要警惕
- 给提交类流程加主体校验时:先看单据上有没有存主体编号;有编号就用编号定位,不要用手机号、名称、地址这些会变的字段反查。造一个“商户换绑手机号后提交”的场景跑一遍,确认仍然放行。
- 把查询结果翻译成用户提示时:把“按这个值没查到”和“这个主体不存在”分开报,提示语要指向能修的那份数据,是合同手机号还是档案绑定手机号;否则一线看到“商户不存在”会去查主体、删改档案,反而绕开真正原因。
- 合同和商户档案各存一份联系方式时:签约写入时做一次一致性比对并留下差异记录;后续任一侧变更要有对账或提醒,别等解约、结算时才暴露。
- 改动上线前回归:拿一个已撤柜、合同在有效期内、商户档案换过手机号的网点走完整关闭流程,确认校验读的是编号字段,且手机号差异只提示不拦截。