发生了什么

平台做的是网点生意:网点要有场地,场地由房东提供。房东分两类,一类由平台直接接洽、直接在系统里录入业务信息,叫直签房东;另一类通过签合同进来,叫三方房东。商户是实际经营的一方,一个商户可以在多座城市开展业务,所以"这个商户在哪几座城市有经营资格"是平台里一份独立的数据,通常叫商户的城市数据权限。

商户有一个自己的应用,登录后只能看到名下有权限的城市的数据。所谓有权限,就是系统认得这个商户和这座城市有关系:商户打开页面时,程序先取当前商户,再判断它有没有当前城市的权限,没有就返回未拥有该城市权限,页面因此不展示这座城市的数据。

正常流程下,房东入驻这一步就该把这份关系建立起来。直签房东走新增业务信息的方式;三方房东走合同签署,签署完成后系统落一条商户与城市的关联记录,权限据此生效,商户登录就能看到该城市的数据。

这次是一个商户登录后看不到合作城市的数据,页面提示未拥有该城市权限。排查下来:三方合同签署完成后,系统确实生成了商户与城市的关联记录,但没有同步更新商户信息表上的城市字段;而权限判断读的正是商户表上这个城市字段。字段是空的,判断自然返回没有权限。按同一口径排查存量,一共有 64 条商户数据存在同样的缺口。

这 64 条商户的关联城市无法自动赋权。如果这些商户没有另行申请对应的数据权限,就会影响他们查看和使用商户端功能。处理分两步:先用脚本把这 64 条商户的城市字段补齐;再修改三方合同签署这条路径,签署完成时同时更新商户信息表的城市字段,该修复已发布上线。

本质

  1. 同一件事存了两份。"商户和哪座城市有关"这份数据,一处是签约流程产出的商户与城市关联记录,一处是商户信息表上直接存的城市字段。前者用来留痕,后者是为了查询方便,两份表示的是同一件事,就必须同步变化。
  2. 写入路径只写了一份。三方房东走合同签署,签署完成时只写了关联记录,漏掉了商户表上的城市字段。于是签约进来的商户,在关联记录里有城市,在商户表上却是空的。
  3. 校验读的是漏写的那一份。权限判断拿到当前商户后,只比对商户表上的城市字段,不看关联记录。字段为空就返回没有权限,哪怕关联记录里明确写着这座城市。

判断权限读的字段,和写入流程维护的字段不是同一个,写入成功并不代表校验能通过,中间差着一次回写。

  1. 需求评审没有确认这份数据由谁维护。自动赋权的方案写的是按手机号到房东入驻记录里取启用中的商户和合作城市;实现时改成按商户表的城市字段校验。产品没说清签约后要不要更新商户表的城市字段,研发也没评估到有多种数据来源、这个字段存在缺失,最后一头按写入理解、一头按读取实现。
  2. 结果就和入驻方式绑定了:功能能不能用,取决于商户是哪种方式进来的。合同签署进来的商户,关联记录有、商户表没有,自动赋权就失效。

记录中的处理是回刷 64 条存量数据,并在签约路径上补回写。这能修正已有的缺口,也堵住了同一个来源。更彻底的方向是让校验直接查关联记录,或在校验时对"字段为空但有关联记录"做兜底,这样即使将来又多一条写入路径漏了回写,权限也不会跟着失效;如果继续保留这份冗余字段,就要保证所有写路径都更新它,并在发布前用关联记录与字段做一次差集核对。校验侧是否按这个方向改造,现有信息里没有说明。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 三方房东合同签署完成后的处理:登记商户与城市的关联
@Transactional
public void onContractSigned(ContractSignedEvent event) {
    Merchant merchant = merchantMapper.selectByPhone(event.getPhone());

    // 为什么错:关联记录写下去了,商户表上的城市字段却没跟着更新,
    // 而下游权限判断只认那个字段
    merchantCityMapper.insert(merchant.getId(), event.getCityCode());

    merchantMapper.updateStatus(merchant.getId(), MerchantStatus.ENABLED);
}
// 商户端页面打开前的城市权限判断
public boolean hasCityPermission(Long userId, String cityCode) {
    Merchant merchant = merchantMapper.selectByUserId(userId);

    // 为什么错:只比对商户表字段;签约流程不写它时,
    // 关联记录里明明有这座城市,这里仍然返回 false
    return cityCode != null && cityCode.equals(merchant.getCityCode());
}

修复代码示例

@Transactional
public void onContractSigned(ContractSignedEvent event) {
    Merchant merchant = merchantMapper.selectByPhone(event.getPhone());
    merchantCityMapper.insert(merchant.getId(), event.getCityCode());

    // 修复点:同一事务内把合作城市回写到商户表,
    // 让权限判断读到的字段和关联记录保持一致
    merchantMapper.updateCityCode(merchant.getId(), event.getCityCode());
    merchantMapper.updateStatus(merchant.getId(), MerchantStatus.ENABLED);
}
-- 存量补齐:按关联记录回刷商户表城市字段(示意,执行一次)
UPDATE merchant m
  JOIN merchant_city mc ON mc.merchant_id = m.id
   SET m.city_code = mc.city_code
 WHERE m.city_code IS NULL
   AND mc.status = 'ENABLED';

下次遇到这些场景要警惕

  • 需求要把某个字段当作权限或资格依据时:先把写这个字段的流程全部列出来(直接录入、合同签署、审批回调、批量导入),逐条确认都会写;只在新增路径上验证,漏写的往往是最晚加进来的那条旁路。
  • 用冗余字段做校验时:完整走一遍新路径(签署完成、赋权、登录看数据),落库后立刻比对关联记录和主表字段,两个值不一致就说明写入端缺一步,不要等业务方反馈。
  • 给存量数据补字段之前:先按关联记录和主表字段做差集,差集不为零说明历史路径也没写全,补数据只解决当下这一批;同时要确认补完的字段不会再被别的流程覆盖回空值。
  • 修复只补了写入端时:再构造一次"字段为空但关联记录存在"的数据,看权限判断是否仍直接拒绝;如果仍拒绝,说明校验侧还需要兜底或改读权威来源。