发生了什么

网点签约业务里,公司租用房东的场地开店,双方签租赁合同。签约后台要按合同给房东付租金、开发票,所以合同上必须记清“甲方”是哪个经营主体,这个经营主体在业务里叫商户。一个手机号在商户平台可以关联好几个商户,登录时只用其中被设为“默认登录商户”的那一个。

签补充协议,是对已经生效的合同改条款,比如租金、租期、发票类型。提交之前,系统要让经办人确认甲方信息,并和合同上原来记下的商户比对;一旦不一致,就弹出“商户信息变更,请重新确认甲方信息”,不允许继续提交。

正常流程是这样:签上一份协议时,系统只拿到房东的手机号,于是去商户平台按手机号查,取这个手机号下的默认登录商户,把它的商户编号写进合同表;之后每次签补充协议,都按同一方式再查一遍,和表里存的编号比较,相同就放行。

这次不同的是,房东在商户平台把自己名下的默认登录商户从 A 换成了 B。这是平台允许的日常操作,和任何一份合同的效力都没有关系。经办人再签补充协议时,系统按同一个手机号解析出来的是 B,和合同表里存着的 A 不相等,于是判定“商户信息变更”,页面停在补充协议的提交环节。经办人把商户资料翻了一遍,也没有发现任何异常,因此一开始判断不出原因。

影响是这份补充协议签不了,签约流程卡在这一步;现场只能先让房东把默认登录商户改回 A,才能提交成功。

本质

一句话:合同甲方的身份,是靠“手机号当前对应的默认登录商户”临时解析出来的,而这个默认项房东随时能改;再拿解析结果去比对历史存下的编号,就会把一次与签约无关的正常变更,误判成商户信息变更。

  1. 原流程。系统解析甲方时只拿到一个手机号,于是去商户平台查这个手机号,取默认登录企业的编号,把它当作甲方商户写进合同表。这一步把“登录偏好”当成了“合同主体”。
  2. 变更。房东在商户平台把默认登录商户从 A 改成 B。A 和 B 都登记在他名下,改默认项不影响合同效力,商户资料本身也没有异常。
  3. 再次签约。系统还是按手机号解析,这次得到 B;校验代码把 B 与合同表里的甲方商户编号 A 比较,发现不相等,抛出“商户信息变更,请重新确认甲方信息”。
  4. 为什么是误判。这个校验要回答的是“甲方有没有被换成另一家”,但两次取值不是同一个口径:历史值是签约当时按默认项解析出来的结果,当前值是房东改过默认项之后重新解析出来的结果。口径不同却直接比较相等性,只要房东动过默认项,就一定会报警。
  5. 结果。签约被拦在提交环节,运营按“商户信息变更”去排查,看到的却是两个都正常的、同属一个房东的商户,所以查不出问题。

手机号解析出来的是可随时更改的“默认登录商户”,不是合同甲方本身;拿它和合同里存的编号比相等,默认项一改就会误拦。

处置上,临时办法是把默认登录商户改回与合同表一致,这样能提交,但只是绕过校验,不是修复。修复方向是签约链路上按商户编号精确匹配,不再用手机号推默认商户;把历史上因同一规则写错的甲方商户编号拉出来刷数校正;两项完成后再灰度上线。存量刷数与灰度都还没有开始,修复上线状态待确认。

错误代码

// 按手机号解析甲方商户(脱敏教学示例)
public MerchantDTO queryMerchantByPhone(String phone) {
    MerchantDTO account = merchantClient.queryByPhone(phone);
    // 为什么错:取的是该手机号下的“默认登录商户”,这是用户随时可改的登录偏好
    String enterpriseId = account.getDefaultEnterprise().getId();
    return merchantClient.queryMerchant(enterpriseId);
}

// 签补充协议前的甲方校验
Long stored = contract.getPartyAMerchantId();
Long current = merchantServiceClient.queryMerchantByPhone(landlord.getPhone()).getId();
if (!Objects.equals(stored, current)) {
    // 为什么错:把“按默认项重新解析的结果”与“签约时存下的编号”直接比相等
    // 房东改过默认登录商户就会命中这里,而商户资料其实是同一家
    throw new BizException("商户信息变更,请重新确认甲方信息");
}

修复代码示例

// 修复:签约链路上按商户编号精确查,不再用手机号推默认商户(脱敏教学示例)
public MerchantDTO queryMerchant(Long merchantId) {
    // 修复:调用方带来明确的商户编号,解析结果不再随登录偏好变化
    return merchantClient.queryMerchant(String.valueOf(merchantId));
}

// 校验改为比较“本次明确提交的甲方”与合同甲方,而不是重新解析出的默认商户
Long stored = contract.getPartyAMerchantId();
Long submitted = supplement.getPartyAMerchantId();
if (submitted == null) {
    // 修复:没有明确甲方就要求经办人选择,不替用户猜一个默认主体
    throw new BizException("请选择甲方商户");
}
if (!Objects.equals(stored, submitted)) {
    throw new BizException("商户信息变更,请重新确认甲方信息");
}

两段代码改的是同一处:解析依据从“手机号对应的默认登录商户”换成“调用方明确传入的商户编号”,比较对象也随之从“重新解析的结果”换成“本次提交的甲方”。存量中被写错的甲方商户编号要单独按签约当时的真实甲方核对后刷数,改代码不会自动纠正它们;灰度范围与验证结果没有更多信息。

下次遇到这些场景要警惕

  • 需要判断“这单属于哪个主体”时:把解析依据写下来逐条看;只要里面出现默认项、最近一次登录、当前选中项这类用户可改的字段,就改成显式传入编号,并在入口校验这个编号确实属于该用户。
  • 用历史快照和当前值做一致性校验时:先确认两次取值同源同口径;一个是签约时的快照、一个是实时解析,就不能直接比相等,否则正常变更会被当成异常拦下。
  • 同一手机号能关联多个主体时:构造“先签一次、改掉默认项、再签一次”的用例,观察是否被误判为主体变更;这类用例要放进签约主流程的回归。
  • 决定收紧匹配规则或改解析方式前:先拉出历史上存过该字段的记录,和当前解析结果比对,估出需要刷数的规模,再排灰度顺序。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;方法名、字段名与编号规则均为示意。