发生了什么

换电柜是给骑手更换电池的柜子,一般放在路边或园区的网点里。骑手在 App 上看到附近网点,跟着导航走过去,扫码或手输柜号打开格口,把没电的电池换下来。导航准不准,直接决定他能不能找到柜子。

柜子自带的定位偏差较大,所以城市运维在网点勘探时,要在后台地图上把点位拖到柜子的实际位置,保存成这个网点的位置。正常流程是:运维保存点位后,这个坐标要落到三处——骑手端导航读取的网点位置、该网点下每台电柜的经纬度、换电地图的缓存;此后骑手按新点导航,手输柜号时的距离校验也按新点算。

这套定位能力是分批上线的:4 月下旬先加了一版点位校验,7 月上旬细化了校验规则,并新增电柜各方位照片,方便骑手对照照片找柜。7 月 29 日,一个网点相关的需求提测后,测试发现骑手端的网点导航位置不对,把问题同步给了开发、产品和业务;开发与履约侧对接口时进一步发现,网点位置数据根本没有同步给履约侧。

原因是保存点位时只更新了网点自己的位置记录,没有同步设置该网点下电柜的位置,而骑手端实际查询的是电柜位置。于是运维在后台把点拖对了,骑手看到的还是旧点位。骑手到不了柜子,换电失败并进线投诉;到 7 月,这类客诉已降到每月 41 起。同期上线的方位照片也帮不上太多忙:照片是勘探时拍的,那时柜子还没装,新增照片里真正拍到电柜的不足一半,骑手无法靠照片确认柜子在哪。

本质

问题的核心不是打点不准,而是"改了一个位置,只写进了一份数据"。网点位置在系统里有多份副本,各自服务不同读方:

  1. 网点自己的位置记录,是运维在后台编辑和查看的那一份。
  2. 骑手端导航读取的柜体配置,按网点维度保存 C 端展示和带路用的坐标。
  3. 电柜运营配置,保存该网点下每台电柜的经纬度。骑手扫码时不会拦截,但手输柜号时会用这份坐标校验骑手与柜子的距离,超过 500 米就拦下。
  4. 换电地图的缓存,决定地图上那个点画在哪里。

运维保存新点位时,程序只执行了第 1 步就返回成功,页面上点位确实动了,看起来一切正常。第 2、3 步没有任何代码去改,第 4 步也没有清缓存。结果是:后台显示的位置是新的,骑手端导航、距离校验和地图仍按旧坐标工作,两边长期不一致。

后台把点位改对了,但骑手端读的是另一份位置数据,改动从未到达。

更麻烦的是历史数据:在同步逻辑补上之前已经修正过的网点,几份副本里留的还是旧坐标,只补代码不会自动纠正它们,需要靠后台的网点修复功能逐条回刷。

修复方向是:定位校验通过后,以运维手机上报的位置作为网点新点位;在同一个保存动作里同步更新骑手端导航读取的网点位置、该网点下所有电柜的经纬度,并在事务提交后清除地图缓存;对历史已修改的网点用修复功能回刷;同时补齐电柜各方位照片。修复分四个版本发布,8 月上旬的版本补上了向履约侧同步点位,全量生效情况待确认。

错误代码

public void saveStationLocation(LocationForm form) {
    // 校验三个定位点是否都在允许范围内,通过才允许保存
    locationValidator.check(form.getPoints());
    // 方位照片单独入库,供骑手对照找柜
    photoRepository.saveAll(form.getStationId(), form.getPhotos());
    // 为什么错:只更新了网点主记录,骑手端导航读取的柜体配置没有同步
    stationRepository.updateLocation(form.getStationId(), form.getLng(), form.getLat());
    // 为什么错:该网点下所有电柜的经纬度仍是旧值,距离校验按旧点计算
    // 为什么错:地图缓存未失效,页面继续展示旧点位
    // 为什么错:这里直接返回成功,调用方看不到副本没改这件事
    log.info("station location saved, station={}", form.getStationId());
}

修复代码示例

@Transactional
public void saveStationLocation(LocationForm form) {
    locationValidator.check(form.getPoints());
    photoRepository.saveAll(form.getStationId(), form.getPhotos());

    int rows = stationRepository.updateLocation(
            form.getStationId(), form.getLng(), form.getLat());
    if (rows == 0) {
        throw new BizException("网点不存在,定位未保存");
    }
    // 同步骑手端导航读取的网点位置,导航才会指向新点位
    cabinetConfigRepository.updateStationLocation(
            form.getStationId(), form.getLng(), form.getLat());
    // 同步该网点下所有电柜的经纬度,扫码与手输柜号的距离校验才按新点算
    cabinetRepository.updateLocationByStation(
            form.getStationId(), form.getLng(), form.getLat());
    // 事务提交后再失效缓存,避免提交前回源把旧坐标写回
    afterCommit(() -> stationCache.evict(form.getStationId()));
}

下次遇到这些场景要警惕

一个位置或状态被多张表各存一份时:动手前先列出所有读取方——导航取哪张表、距离校验取哪张表、地图和列表取哪份缓存,保存后用一条真实数据逐处核对新值,不要只看编辑页回显。

给已有数据加"修正"能力时:把历史数据回刷做成可重复执行的操作,并在测试环境拿一条旧数据跑一遍,确认修正结果确实落到每个读取方。

地图或列表上的点位来自缓存时:在事务提交后失效缓存,并确认缓存重建读的是已更新的那张表,而不是另一份旧副本。

用现场照片做找柜兜底时:先确认照片拍的是目标设备本身;增量照片里目标设备缺失时,不能把它当作可用的找柜依据。