发生了什么
换电是骑手把车上没电的电池放进电柜、再取一颗满电电池的业务。电柜是摆在点位上的设备,系统里每台电柜有一条记录,记着编号和经纬度。骑手到了不熟悉的区域,会在手机里搜索附近的换电柜,结果按离自己的距离从近到远排,点最上面那台过去换电。
正常流程是:用户发起搜索,页面把当前位置和搜索条件交给换电搜索接口;接口从正在使用的电柜里筛出符合条件的一批,按距离排好序,再切出第一页返回。这样排在第一位的,应该是全部候选里离用户最近的那台。
这次有多位用户反馈:搜索出来的电柜都不是附近的,离自己最近的那台没有出现在列表里,排在前面的反而是更远的柜子;换到陌生区域时更明显,找柜要多绕路。
排查后确认,搜索接口的取数是先分页、后排序。分页是把长列表切成若干页、一次只返回一页的机制;分页组件会把“第几页、每页多少条”翻译成 SQL 里的截断条件。接口先用这个条件从数据库取回一页电柜,再在程序内存里按距离给这一页重新排队。结果就是:先被选出来的只是取数顺序上的一页,不是最近的一批;内存排序只能改这一页内部的顺序,改不了这一页有谁。
本质
用户要的是“全部在用电柜里离我最近的几台”,代码给出的却是“某一页电柜里相对最近的几台”。差别不在排序算法,而在排序和截断的先后。
- 搜索请求带着用户位置进入接口,候选集合是全部符合筛选条件的在用柜子。
- 接口调用分页组件查询。组件把页码和每页条数拼成 SQL 的截断条件,附在查询后面;此时 SQL 里没有按距离排序,取这一页的顺序与用户位置无关。
- 这一页取回后,程序在内存里按距离排序。排序本身没有算错,这一页内部确实从近到远;但被排序的集合已经被页边界定死了。
- 离用户最近的柜子如果在取数顺序里排在页外,就不会出现在这一页。翻到下一页,拿到的是另一批同样没有按距离挑选过的记录,再排一次也只是那批记录内部的顺序。用户看到的现象就是列表里有一批柜子,最近的偏偏不在。
- 修复方向是把距离计算和排序一起下推到 SQL 的 ORDER BY,让分页组件截断的是已经按距离排好的结果。排序先发生、截断后发生,页边界才会落在“最近的第 N 台”之后。这次只留下“已完成”的结论,没有写改动覆盖了哪些搜索入口、什么时间上线、如何验证,因此修复是否全面生效待确认。
分页先截断、排序后执行,页内排得再正确,也换不回被页边界挡在外面的近柜。
以下两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
public class SwapSearchService {
private final CabinetRepository cabinetRepository;
public List<Cabinet> searchNearby(double lng, double lat, int pageNo, int pageSize) {
// 为什么错:分页组件先把 LIMIT 拼进 SQL,取回的是与距离无关的一页
List<Cabinet> page = cabinetRepository.pageOnline(pageNo, pageSize);
// 为什么错:距离排序在取页之后才做,只能给这一页重排;
// 页外的近柜不会因为排序被拉进来
page.sort(Comparator.comparingDouble(c -> distanceInMeters(c, lng, lat)));
return page;
}
}
修复代码示例
public class SwapSearchService {
private final CabinetRepository cabinetRepository;
public List<Cabinet> searchNearby(double lng, double lat, int pageNo, int pageSize) {
// 修复:不再先取一页再排序,排序和分页交给同一条 SQL
return cabinetRepository.pageNearest(lng, lat, pageNo, pageSize);
}
}
interface CabinetRepository {
// 示意 SQL:距离在库里算,ORDER BY 发生在 LIMIT 之前
// SELECT id, cabinet_no, lng, lat,
// ST_Distance_Sphere(POINT(lng, lat), POINT(?, ?)) AS distance
// FROM cabinet
// WHERE status = 'ONLINE'
// ORDER BY distance
// LIMIT ?, ?
List<Cabinet> pageNearest(double lng, double lat, int pageNo, int pageSize);
}
下次遇到这些场景要警惕
- 给“按距离、评分或价格排序”的列表接分页时:先确认排序字段写在 SQL 的 ORDER BY 里,再构造“最近的记录在取数顺序里本来排在后面”的数据,看第一页是否仍然是最近的几条;只在页内排序的实现会在这里露出来。
- 看到查询返回后又调用排序方法时:问清楚这次排序是在“选哪些记录”还是“只改展示顺序”;如果它承担了选出最近若干条的职责,就把它和分页一起下推到 SQL,再用同一组数据对比改动前后的第一页,确认最近的记录确实排到了最前面。
- 搜索类接口上线前:用一个固定坐标和几台已知位置的柜子核对返回顺序与距离,而不是只看列表有没有数据、条数对不对。
- 修复排序问题后:分别检查第一页和后续页,确认每一页都是按距离连续切出来的;只验第一页可能掩盖页边界仍然错位的情况。