发生了什么

换电柜业务中,用户到柜前扫码取还电池。用户可以预先买一份套餐,套餐就是一段期限内的换电使用权。套餐由渠道商户卖出,所以每条套餐都要记录自己属于哪个商户,这份记录在业务里叫“归属”。

用户在柜前扫码时,系统先做套餐校验,把套餐和归属商户一起带出来,再看这个网点的运营配置允不允许这位商户的用户使用:允许就开仓,不允许就拦下。

正常流程是:用户扫码 → 套餐校验返回套餐和归属商户 → 柜前校验按商户匹配网点的放行规则 → 放行后开仓换电。

这次改动是为了给渠道信息加缓存。渠道信息读得很频繁,开发希望先把渠道商户查出来放进缓存,减少对数据库的访问。加缓存的同时,他们优化了底层的渠道数据访问对象,为了让新旧接口共用,直接复用了原来的一部分查询语句,但没有逐条评估这些语句原本是用在什么场景下的。

上线后有用户反馈:自己买过套餐,到柜前扫码却被拦下,换不了电。查下来,套餐校验没有带回归属商户;两个用户扫的网点又都关闭了“允许合作商户用户使用”的开关,校验在匹配不到商户的情况下把用户拦了下来。

本质

问题出在两处:把为旧场景写的查询直接拿到新接口里用;以及随后把“查不到记录”当成“业务上确实没有”。

  1. 原来的流程里,套餐校验按渠道去查对应商户,查到后把商户编号填进套餐结果,柜前校验才能拿这个编号去匹配网点的放行规则。
  2. 加缓存时,加载缓存用的查询被收进渠道数据访问对象。为了少写一份查询,新接口直接调用了原来某处在用的那条语句。
  3. 那条语句是为原来的场景写的,条件里带着那个场景才需要的过滤。新接口的查询场景不同,这些条件在新场景下并不成立,查询返回空。
  4. 新接口把空结果解释成“这个渠道没有商户”,既没有报错也没有告警,还把空结果写进了缓存,缓存有效期内后续请求读到的都是空。
  5. 套餐校验拿不到商户编号,套餐就以“没有归属”的样子返回;柜前校验按归属商户匹配放行规则,归属为空就匹配不上,用户最终被网点配置拦下。

查询方法被两个场景共用,旧场景的过滤条件跟着进了新场景;“查不到记录”被当成“业务上确实没有”,落到用户身上就是套餐丢了归属、柜前换不了电。

这次问题的处置是终止异常代码的发布,并对受影响的订单做数据订正。修复方向是:新接口使用只服务自己场景的查询,不再共用旧语句;查不到记录时不写缓存,打日志并告警;套餐归属缺失时不要静默按“无归属”继续走,要在校验环节明确拦住并留下可追查的信息。修复上线状态待确认。

错误代码

// 渠道数据访问对象:旧场景的查询,WHERE 里带着旧场景才需要的过滤条件
public interface ChannelMerchantDao {
    // 新接口直接复用了这条语句,但新场景并不满足这些过滤条件
    ChannelMerchant selectForPageList(@Param("channelId") Long channelId);
}

// 缓存加载:新接口调用旧语句,查不到就把空结果写进缓存
public ChannelMerchant loadChannelMerchant(Long channelId) {
    // 为什么错:旧语句带着旧场景的过滤条件,新场景下不成立,这里恒返回 null
    ChannelMerchant merchant = channelMerchantDao.selectForPageList(channelId);
    if (merchant == null) {
        channelCache.put(channelId, null); // 为什么错:空结果被缓存,整个缓存周期都不再回查
        return null;
    }
    channelCache.put(channelId, merchant);
    return merchant;
}

// 套餐校验(另一段逻辑):取不到商户就按“无归属”返回,调用方无从分辨
Long attributionMerchantId = merchant == null ? null : merchant.getMerchantId();
packageInfo.setAttributionMerchantId(attributionMerchantId);
// 柜前校验:归属为空时匹配不上放行规则,用户被网点配置拦下
if (!siteConfig.allows(attributionMerchantId)) {
    throw new BizException("当前网点暂不可用");
}

修复代码示例

// 修复:新接口用自己场景的查询,只保留该场景必须的条件
public interface ChannelMerchantDao {
    // 按渠道编号精确取商户,不再带旧场景的过滤条件
    ChannelMerchant selectByChannelId(@Param("channelId") Long channelId);
}

// 加载缓存:查不到不写缓存,留下可定位的日志和告警
public ChannelMerchant loadChannelMerchant(Long channelId) {
    ChannelMerchant merchant = channelMerchantDao.selectByChannelId(channelId);
    if (merchant == null) {
        log.warn("channel merchant not found, channelId={}", channelId);
        alarmClient.send("channel_merchant_missing", channelId);
        return null; // 不把空结果写进缓存,避免一次失败被固定成长期空值
    }
    channelCache.put(channelId, merchant);
    return merchant;
}

// 套餐校验:归属缺失就明确失败,不再静默按“无归属”继续
Long attributionMerchantId = merchant == null ? null : merchant.getMerchantId();
if (attributionMerchantId == null) {
    throw new BizException("套餐归属校验失败,请稍后重试");
}
packageInfo.setAttributionMerchantId(attributionMerchantId);

下次遇到这些场景要警惕

  • 给已有查询加缓存或抽公共方法时:先把这条语句的过滤条件逐条列出来,写明每一条件服务的是哪个调用场景;再用新场景的请求跑一遍,确认它能查到该查到的记录,而不是只测旧场景。
  • 查询返回空的时候:在代码里区分“确实没有这条业务数据”和“查询条件把它排除了”;查不到先打日志,别急着写缓存,也不要直接把空值当成业务结论往下传。
  • 新增缓存写入口时:确认空结果不会被长期缓存;构造一次查询失败的场景,观察缓存里是否留下空值、后续请求是否一直拿到空。
  • 业务校验依赖某个字段做归属或放行判断时:给这个字段加判空和告警,验证字段为空时校验是明确失败并留下记录,而不是悄悄走到拒绝用户的默认分支。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名、开关名与查询条件均为示意。