发生了什么

租车业务里,一个“商品”指可租的车辆和租赁方案。后台会把这个商品挂到若干“运营门店”上,表示这些门店都能提供这台车;用户在前端打开商品详情,先选提车门店,再下单。前端本身不判断哪家门店能卖,它调用商品接口,接口返回这个商品可售的门店列表,每家门店带一条报价,前端按返回结果逐家展示。

报价由定价程序给出。门店自己配了价格,就用门店价;门店没有单独配价时,用所在城市统一的价格兜底,这是这次技术改造新增的规则。所以“配置了哪些门店”和“每家门店什么价”是两份数据,最后要按门店拼在一起。没有拿到报价的门店不会展示,这个过滤本身是正常业务:后台配了门店,不代表每家门店在任何时候都能卖。

1 月 5 日,定价灰度开关打开,新的价格处理逻辑开始对一部分商品生效。运营把一个商品配到了同一城市的几家门店,配置同步成功,后台编辑页能看到这几家门店都在运营门店列表里。但用户端商品页只显示其中一家,其余同城门店没有出现。前端拿到的可售门店只剩一条,页面按这条结果展示。

影响是用户只能看到并选择剩下的那一家提车门店,其他已配置的同城门店无法被选择。记录里没有给出受影响商品和门店的总量。处置时先关闭灰度开关,再恢复线上缺失的门店数据,随后发布代码修复缺陷。修复上线后的验证结果,记录里没有更多信息。

本质

一句话:新的定价逻辑在“无门店价、回退城市价”时,没有为同城每家门店分别保留价格归属;几家门店共用同一条城市价,结果组装时被当成同一个商品项,最后只剩一条。

  1. 原流程。定价程序按门店逐家取价,结果按门店各占一条;商品配置了几家可售门店,接口就应返回几条门店报价。城市价兜底是这次新增的取值来源,但无论价格来自哪里,结果都应保持门店粒度。
  2. 这次改动。价格处理逻辑整体调整,新增“无门店价时统一使用城市价”。城市价一条记录对应一座城市,它不知道这座城市里有几家门店,也不属于其中任何一家。
  3. 出错点。批量处理同城门店时,新逻辑没有为每家门店分别保留价格归属,而是以城市为粒度归并门店商品。第一家门店写入后,第二、第三家门店落到同一条城市价上,被当成重复项,没有形成自己的结果条目。
  4. 为什么会被过滤。接口最后只返回有独立条目的门店;其余同城门店找不到属于自己的那条记录,被当作“没有报价”过滤掉。配置数据没有丢,前端也没有丢,丢在定价程序组装结果这一步。
  5. 为什么不容易发现。正常逻辑本来就会过滤没有报价的门店,一个商品配了三家、返回两家也可能是对的,所以单看返回条数判断不了异常;只有同城几家都该展示却只剩一家时才会暴露。

后台的门店配置没有丢,丢在定价程序把同城门店按城市合成了一条;城市价可以共用,门店结果不能合并。

修复方向是让城市价只作为价格值,不参与门店归并:结果仍按门店编号逐条组装,同城多家门店可以引用同一条城市价,但每条门店商品保留自己的门店编号。处置上先关闭开关恢复数据,再发布修复;修复后的回归验证记录里没有更多信息。

错误代码

// 商品配置了 3 家同城门店,接口只返回 1 家(脱敏教学示例)
public List<StoreOffer> listOffers(Long skuId, Long cityId) {
    List<Long> storeIds = configMapper.listStoreIds(skuId, cityId);
    Map<Long, Price> storePrices = priceMapper.mapByStore(skuId, storeIds);
    Price cityPrice = priceMapper.getCityPrice(skuId, cityId);

    Map<Long, StoreOffer> offerMap = new LinkedHashMap<>();
    for (Long storeId : storeIds) {
        Store store = storeMapper.get(storeId);
        Price price = storePrices.get(storeId);
        if (price == null) {
            price = cityPrice;     // 没有门店价时用城市价兜底,这一步本身没错
        }
        if (price == null) {
            continue;              // 无价门店不展示,属于正常过滤
        }
        // 为什么错:用城市编号做结果键,同城第 2、3 家门店覆盖前一家,3 条只剩 1 条
        offerMap.put(store.getCityId(), new StoreOffer(store, price));
    }
    return new ArrayList<>(offerMap.values());
}

修复代码示例

// 修复:城市价只做兜底值,结果仍按门店逐条保留(脱敏教学示例)
public List<StoreOffer> listOffers(Long skuId, Long cityId) {
    List<Long> storeIds = configMapper.listStoreIds(skuId, cityId);
    Map<Long, Price> storePrices = priceMapper.mapByStore(skuId, storeIds);
    Price cityPrice = priceMapper.getCityPrice(skuId, cityId);

    List<StoreOffer> offers = new ArrayList<>();
    for (Long storeId : storeIds) {
        Store store = storeMapper.get(storeId);
        Price price = storePrices.get(storeId);
        if (price == null) {
            price = cityPrice;     // 修复:同一城市的多家门店可以共用这一条兜底价
        }
        if (price == null) {
            continue;              // 仍然只过滤真正没有报价的门店
        }
        offers.add(new StoreOffer(store, price)); // 修复:一家门店一条,价格相同也各自保留
    }
    return offers;
}

两段代码的价格解析完全一样,只改了结果的归并方式:错误版用城市编号当结果键,修复版用列表按门店逐条追加。这样同城门店共享城市价时,价格可以重复,门店不会互相覆盖;真正没有报价的门店仍按原规则过滤。

下次遇到这些场景要警惕

  • 给批量对象增加兜底来源时:先写下“结果对象是谁、兜底记录属于谁”。如果兜底记录比结果对象粗一级,比如城市对门店、商户对门店、车型对车辆,就检查结果归并键,确保仍按最细一级对象逐条保留。
  • 同一父级下会有多个对象共用一条配置时:构造“同一城市 2~3 家门店、其中一家有门店价、其余只有城市价”的用例,断言返回的门店集合与配置中应展示的集合一致,而不是只断言总条数或只测单门店。
  • 想用返回条数做监控时:先确认正常过滤规则,否则少一条和正常过滤无法区分;改成比对“配置应展示的门店集合”和“接口实际返回的门店集合”的差集。
  • 给定价或过滤逻辑加灰度开关时:灰度前用同城多门店商品做新旧逻辑的影子比对,逐门店比较是否出现,不要只看两边返回的总条数是否接近。

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