发生了什么

在用车服务小程序里,「我的优惠券」页面让用户看到自己持有的券:每张券有名称、面额,还有一条跳转地址,用户点一下就能进入对应的商城首页、品类页或商品详情页。这些券来自用车服务业务线,券上带着一个商品编号,列表接口拼跳转地址时就把这个编号拼进本小程序的商品详情页模板。

正常流程是:用户打开页面,前端调用优惠券列表接口;接口只查用车服务业务线的券,为每张券拼出本小程序内的跳转地址;前端渲染后用户点击进入对应页面,商品详情接口按编号正常返回内容。

这一次做的是优惠券整合:产品希望用户在一个入口里同时看到用车服务和换电两个业务线的券。开发改了三处——把列表接口的查询范围从只查用车服务业务线扩大到同时查用车服务和换电;新增一个独立的中转跳转接口,供前端中转页按业务线决定跳去哪个小程序;在跳转配置里新增换电小程序的跳转地址和换电业务线标识两个字段。

发布后约一小时,监控出现「维修商品详情页接口」返回码非零的告警,峰值约每秒 23 次,持续约两小时,累计约 935 条。排查后确认,受影响的是点了换电券的用户:他们被带到用车服务小程序的商品详情页,页面加载失败。换电小程序本身不受影响,也没有订单受到影响。

本质

问题出在列表接口拼跳转地址这一步,它没有跟着查询范围一起改。

  1. 改动之前,列表接口只查用车服务业务线的券。列表里每一条都属于同一个业务线,拼跳转地址时不需要判断业务线,直接把券上的商品编号拼进商品详情页模板即可。
  2. 改动之后,查询范围扩大到两个业务线,列表里开始出现换电券。换电券上的商品编号是换电商品库的编号,和用车服务的商品库不是同一套。
  3. 列表接口拼跳转地址时,没有读券上的业务线标识,仍然把所有券都按用车服务的商品详情页模板拼成「商品详情页地址 + 商品编号」。
  4. 用户点击换电券后,前端拿着这个地址请求用车服务的维修商品详情接口。这个编号在用车服务的商品库里不存在,接口返回非零错误码,页面加载失败,监控随之告警。
  5. 同一个需求里新增的中转跳转接口是处理对的:它拿券上的业务线标识和配置里的换电业务线标识比较,命中就返回换电小程序的跳转参数。也就是说,同一份券数据有两个出口,新出口做了业务线判断,旧出口漏了。

查询范围扩大了,拼跳转地址的分支没有跟着扩大,新增的那一类数据全部落进了旧类型的处理逻辑。

处理过程:先回滚到上一版本,查询范围恢复成只查用车服务,告警逐步消失;随后加了一个默认关闭的配置开关来控制是否合并查询换电券,开关开启后在遍历时按业务线标识分流,命中换电就用换电小程序的跳转地址,其余仍走原来的商品和品类跳转。修复版本重新发布后,告警不再出现。

下面的代码是脱敏教学示例,用来说明查询范围、业务线判断和跳转地址三者的关系,不代表实际项目源码。

错误代码

// 优惠券列表接口:把查到的券转成前端可直接跳转的地址
public List<CouponVO> getUserPropertyList(long userId) {
    // 变更点:查询范围从只查用车服务业务线,扩大到用车服务 + 换电两个业务线
    List<PropertyDTO> properties = propertyClient.queryAllBusiness(userId);
    List<CouponVO> result = new ArrayList<>();
    for (PropertyDTO p : properties) {
        CouponVO vo = new CouponVO();
        vo.setPropertyId(p.getPropertyId());
        vo.setAmount(p.getAmount());
        // 为什么错:不看 p.getBusinessKey(),换电券也套用用车服务的商品详情页模板,
        // 带过去的是换电商品编号,该编号在用车服务商品库里不存在
        vo.setTargetUrl(urlConfig.getGoodsDetail() + "?skuId=" + p.getSkuId());
        result.add(vo);
    }
    return result;
}

修复代码示例

// 修复后:开关控制查询范围,遍历时按业务线标识分流跳转地址
public List<CouponVO> getUserPropertyList(long userId) {
    List<PropertyDTO> properties = config.isMergeBatteryCouponOn()
            ? propertyClient.queryAllBusiness(userId)                  // 开关开启才合并换电券
            : propertyClient.queryByBusiness(userId, VEHICLE_SERVICE);  // 默认保持原查询范围
    List<CouponVO> result = new ArrayList<>();
    for (PropertyDTO p : properties) {
        CouponVO vo = new CouponVO();
        vo.setPropertyId(p.getPropertyId());
        if (urlConfig.getBatteryBusinessKey().equals(p.getBusinessKey())) {
            // 换电业务线:返回换电小程序的跳转参数,不拼用车服务的商品详情页
            vo.setTargetUrl(urlConfig.getBatteryEntry());
        } else {
            vo.setTargetUrl(urlConfig.getGoodsDetail() + "?skuId=" + p.getSkuId());
        }
        result.add(vo);
    }
    return result;
}

下次遇到这些场景要警惕

  • 给列表接口扩大数据来源(新增业务线、类型或渠道):先把这份列表下游所有「按对象类型走不同分支」的地方列出来——跳转地址、详情查询、展示文案、权限校验——逐个确认新类型会命中哪条分支。这次只改了中转跳转接口,漏掉了列表接口的地址拼接。
  • 拿另一个业务域的编号拼链接之前:先确认这个编号在本域能不能解析。构造一条新类型数据,完整点一次,直接看目标接口返回什么,不要假设编号全局唯一、两边的商品库可以通用。
  • 同一需求里有两个出口处理同一份数据:把两处的分支判断逐行对照,确认对新增类型的处理一致;只改新接口、不改继续沿用旧数据的接口,是这类改动最常见的漏改点。
  • 发布后看观测:单节点观测期间日志正常不代表链路没问题,要按业务线、按入口分组看返回码和错误数,并让新增类型的流量先小批量进来,确认没有非零返回再全量。