发生了什么

车辆档案是租车业务里每辆车的一份记录,一行对应一辆实体车,记着车牌号、车辆类型、租赁状态,还有一项“中控编号”。中控编号是装在车上的智能设备的编号,用来把车和后台的设备记录对应起来,改它等于给这辆车换设备。租赁状态为“租赁中”,表示这辆车已经交给用户在使用。

修改车辆信息有两个入口:商家端 App 的车辆管理页面,和管理后台。正常改信息只应改动运营提交的那个字段。中控编号代表车辆当前绑定的设备,换设备要走专门的流程,所以普通信息修改接口会先拦一道:把提交上来的中控编号和库里存的值做比较,不相等就认为这次提交动了设备,直接拒绝,并提示“该车辆中控已绑定暂不支持修改”。

以前车在租赁中不允许修改任何信息,这次需求放开,允许租赁中的车只改车牌号。运营在商家端给一辆租赁中的车改车牌,提交后没有成功,页面弹出上面那句提示。查这辆车的档案,中控编号是空的:数据库里没有登记,取出来是 null;运营只改车牌,前端把中控编号的新值提交成了空字符串。两个值在业务上都表示“这辆车没有登记设备编号”,但接口比较时把它们当成两个不同的值,判定中控编号被修改,整个请求被拒绝,车牌号也没有更新。

排查到中控编号为空、同时正在租赁中的车有 476 辆,这些车在商家端都改不了车牌号,同样的修改在管理后台可以完成。改车牌号本身不影响用户骑行,改成功或没改成功都一样。

本质

问题出在“判断中控编号有没有被修改”这一步。

  1. 商家端的修改请求除车牌号外,还会带上改完之后的中控编号。
  2. 接口拿库里的旧中控编号和请求里的新中控编号做等值比较,只要不相等,就认为这次提交动了设备,进入拒绝分支。
  3. 这辆车库里没有登记设备编号,取出来是 null;前端把没有变化的中控编号提交成空字符串。两者在业务上都表示“空”,但等值比较只认字面值,null 和空字符串不相等。
  4. 比较结果为“不相等”,程序判定中控编号被修改,抛出业务异常,后面的车牌更新没有执行,运营看到的就是那句“已绑定暂不支持修改”。
  5. 这段校验以前在租赁场景走不到:租赁中的车根本不允许改任何信息,请求到不了这里。这次放开只改车牌,才让历史空值数据第一次走到这条判断上。

本质是把“空”的两种常见表示(null 和空字符串)当成两个不同的值,用一次普通的等值比较去回答“业务上到底有没有变化”。修正方向是先把两边的空值归一到同一种表示再比较,并让“租赁中只改车牌”走一个不进入整车校验的独立方法。修复已重新发版上线,同时排查了其它用到中控编号的地方,没有发现同类缺失。

判断“有没有改”之前,先把 null 和空字符串统一成同一种“空”,否则没改也会被判成改了。

错误代码

public void updateVehicle(VehicleUpdateReq req) {
    Vehicle old = vehicleMapper.selectById(req.getVehicleId());
    String oldEcuNo = old.getEcuNo();          // 库里没有登记设备编号时是 null
    String newEcuNo = req.getEcuNoAfter();     // 前端没有变化时提交空字符串

    // 为什么错:equals 只比字面值,null 和 "" 都表示“没有设备编号”,
    // 这里却被当成两个不同的值,没改设备也被判成改了
    if (!StringUtils.equals(oldEcuNo, newEcuNo)) {
        // 为什么错:误判后拒绝整个请求,车牌号也没有机会更新
        throw new BizException("该车辆中控已绑定暂不支持修改");
    }
    vehicleMapper.updatePlateNo(old.getId(), req.getPlateNo());
}

修复代码示例

// 改:把 null、空字符串和只含空格的字符串统一成同一种“空”
private static String normalizeEcuNo(String ecuNo) {
    if (ecuNo == null || ecuNo.trim().isEmpty()) {
        return null;
    }
    return ecuNo.trim();
}

public void updateVehicle(VehicleUpdateReq req) {
    Vehicle old = vehicleMapper.selectById(req.getVehicleId());
    String oldEcuNo = normalizeEcuNo(old.getEcuNo());
    String newEcuNo = normalizeEcuNo(req.getEcuNoAfter());

    // 改:两边归一后再比较,都为空时不会进入“设备被修改”分支
    if (!Objects.equals(oldEcuNo, newEcuNo)) {
        throw new BizException("该车辆中控已绑定暂不支持修改");
    }
    vehicleMapper.updatePlateNo(old.getId(), req.getPlateNo());
}

// 改:租赁中只改车牌走独立方法,不再进入整车字段校验
public void updatePlateOnly(Long vehicleId, String plateNo) {
    vehicleMapper.updatePlateNo(vehicleId, plateNo);
}

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

下次遇到这些场景要警惕

  • 给原本禁止修改的对象放开某个字段时:先列清这条入口上还挂着哪些校验,再从库里找一条该字段为空的历史数据,按新路径实际提交一次,确认返回成功,而不是被旧校验拦下。
  • 用“新旧值是否相等”判断有没有修改时:先确认两端对“空”的表示是否一致。造两组数据各跑一次:库里为 null、请求传空字符串;库里为 null、请求省略该字段。观察是否被误判成修改。
  • 历史数据里某个字段大量为空时:上线前统计空值条数(这次是 476 辆),把其中处于业务限制状态的记录挑出来做回归样本,不要只测字段都有值的正常数据。
  • 前端会把没有变化的字段一起回传时:确认空值传到后端是 null 还是空字符串,并在接口测试里同时覆盖字段缺省、显式 null、空字符串三种输入。