发生了什么

商户要在某个场所做经营,得先签一份场所租赁合同。合同签完,系统按合同内容建一份网点档案,之后这个场所的运营和结算都按网点来办。合同由运营在后台表单里填写,其中一项是“租金收款人邮箱”,用来接收合同附件和跟租金有关的通知。

正常流程是:运营把表单填完提交,签约程序校验商户信息,通过后把合同推进到已签约,网点进入待运营。校验要确认这个商户有一个能用的邮箱,否则后续发不出合同附件。

这次运营在表单里明确填了收款人邮箱,提交后仍被拦下,提示“商户邮箱未维护,请检查商户平台邮箱信息”。运营去商户平台上找,也说不清该在哪里补,反复提交都是同一句提示,这一单签不下去。

本质

问题在于“商户邮箱”这个说法背后有两份数据,而校验读的不是运营刚填的那份。

  1. 合同表单采集的是“租金收款人邮箱”,随合同一起保存,由填表的运营维护。签约校验没有读它。
  2. 签约程序按手机号查出商户,再用商户去账户中心查这个手机号绑定的账号,取账号上的“账号邮箱”做必填判断。账号邮箱属于商户平台的账户中心,由商户自己登录后台维护。
  3. 有一部分商户账号是系统批量创建的,创建时没有写账号邮箱,商户也从未登录过商户平台。对这类账号,账户中心返回的账号信息里没有邮箱这一项。
  4. 签约程序只判断账号邮箱是否为空,为空就抛“商户邮箱未维护”。它不回看合同表单已经提交的收款人邮箱,也不区分“账号从没被维护过”和“商户故意没填”。
  5. 这段校验原本受配置中心的城市灰度清单控制,只对清单里的城市生效。清单最近被改成全国生效,于是所有城市都走这段校验,所有系统建号的商户首次签约都会撞上同一条提示。

合起来就是:用户填在合同表单里的邮箱没有被使用,被校验的账号邮箱对系统建号的商户必然为空,两个不同来源的字段被当成同一个“商户邮箱”,拦截面又被灰度放开到了全国。

修复方向是:由产品方案明确签约场景“邮箱”的唯一权威来源为合同表单的收款人邮箱,签约校验改为优先取它、账号邮箱只作兜底;同时把提示文案改成能指出是哪个账号缺邮箱、去哪里补。更彻底的做法是直接移除对账号邮箱的强校验、只以表单邮箱为准,这会改变现有的拦截语义,需要连同产品方案一起评估。修复与上线状态待确认。

另有一处连带风险要一并评估:现有拦截条件是“命中灰度且账号邮箱为空”,如果按计划把城市灰度代码下架,条件会变成“账号邮箱为空就抛错”,原本被开关挡住的存量账号会全部转为签约失败。下架前应先完成字段口径调整与强校验移除。

错误代码

// 签约校验:按手机号查商户,再拿账号邮箱做必填判断
public void checkMerchantEmail(String phone, ContractForm form) {
    MerchantInfo merchant = merchantQueryClient.queryByPhone(phone);
    AccountInfo account = accountClient.querySingleAccount(merchant.getAccountId());

    // 为什么错:取的是账户中心的“账号邮箱”,
    // 而运营填的是合同表单里的“租金收款人邮箱”,form 根本没被读取
    String email = account.getEmail();

    if (StringUtils.isBlank(email)) {
        // 为什么错:系统批量建号的账号本来就没有邮箱,
        // 这一句把“账号从没维护过”直接判成“不能签约”
        throw new BizException(ERR_EMAIL_REQUIRED);
    }
}

修复代码示例

// 同一个入口、同一个 form,只改邮箱的取数来源
public void checkMerchantEmail(String phone, ContractForm form) {
    MerchantInfo merchant = merchantQueryClient.queryByPhone(phone);
    AccountInfo account = accountClient.querySingleAccount(merchant.getAccountId());

    // 修复:签约场景以合同表单采集的收款人邮箱为准,账号邮箱降为兜底
    String email = StringUtils.firstNonBlank(
            form.getLandlordEmail(),
            account.getEmail());

    if (StringUtils.isBlank(email)) {
        // 修复:两处都没有才拒绝,提示要写明是哪个账号、去哪里补
        throw new BizException(ERR_EMAIL_REQUIRED_WITH_HINT);
    }
    // 后续按 email 继续签约流程
}

下次遇到这些场景要警惕

  • 同一业务含义存在多个存储位置(合同表单、商户档案联系人、账户中心账号)时,先把“谁写入、谁读取、哪个权威”列成一张表,再造一个从未登录过的新商户走完整签约,确认校验读到的就是刚填的那个值。
  • 把依赖灰度或白名单的校验放开到全国、全量之前,先用“系统建号且从未登录”的账号跑一遍,确认新范围里没有必然为空的必填项。
  • 看到“某字段未维护”的提示时,先确认提示里的字段和用户填的字段是不是同一个;文案应指出具体账号和补录入口,否则运营无法自助判断,只能反复提单。
  • 准备下线灰度分支时,先写出该分支当前承担的全部判断职责,逐条确认去掉开关后条件是否改变;像“命中灰度且字段为空”这种组合条件,去掉灰度往往是扩大拦截范围,而不是解除拦截。