发生了什么
租车业务里,每辆对外出租的车在系统里有一份车辆档案:一行记录代表一辆实体车,记着车牌号、车辆类型、租赁状态等。车辆类型只有两种,智能车和非智能车,类型决定这辆车按哪一类对外提供租用服务,也决定后台和商家端把它显示成哪一类。租赁状态为“租赁中”,表示这辆车已经交给用户在使用。
改车辆信息有两个入口:服务站后台的车辆管理页面,和商家端 App 的车辆修改。正常改一辆车的信息,只应该改动运营提交的那个字段。比如只改车牌号,车辆类型、租赁状态这些没有提交的字段要保持原样,页面上也不该出现别的变化。
这次业务要支持“改车牌号”,服务端为此加了一个专门改车牌号的更新方法。运营在页面上把一辆租赁中的智能车的车牌号改掉,提交成功,接口没有报错,页面也没有异常提示。但改完之后,这辆车的车辆类型变成了非智能车,后台和商家端都这样显示,正在租用这辆车的用户在客户端也无法继续正常使用。
从当天晚上到次日修复上线之间,凡是走这两个入口对智能车做过任意字段更新的操作,都把车辆类型写成了非智能车。其中一部分车正在被用户租用,随后产生了客诉。修复上线后,按更新时间落在这个窗口、且智能车标识由 1 变成 0 的记录,可以把被改坏的车辆筛出来再逐条处理。
本质
车辆档案在程序里对应一个车辆对象,更新时把这个对象交给持久层,由更新语句写回数据库。这次的问题出在新增的改车牌号方法上:
- 这个方法没有先把这辆车的档案查出来再改字段,而是新建了一个车辆对象,只填了车辆标识、车牌号和更新时间三个值。
- 车辆对象里表示智能车的字段是基本类型 boolean。基本类型没有“未赋值”这个状态,新建对象时它就已经是 false,也就是非智能车。
- 更新语句按对象整行写回,为每个字段都生成赋值,包括这个没有被赋值的智能车字段。数据库里的智能车标识于是被写成了 0。
运营只想改车牌号,一个没被赋值的布尔字段却把数据库里的智能车标识从 1 覆盖成了 0。
- 车辆类型读的就是这个字段,页面、商家端和用户端随后都把这辆车当成非智能车,正在租用的用户用不了车,客诉由此产生。
- 整个更新过程没有异常:接口正常返回,运营看到的是修改成功。只有再去查这辆车,或用户反馈用不了车,才会发现类型被改了。更新前后也没有比对关键字段的变化,这次改写没有在当时被拦下。
修复方式是把智能车字段从基本类型改成包装类型,未赋值时是 null,更新语句只写非 null 的字段,这样只改车牌号时不会再碰智能车标识。这个修改已上线。已经写坏的数据仍需按上面的时间窗口和字段变化单独筛查恢复,代码修复不会自动回填;另一条可选做法是让更新语句只允许写车牌号、更新时间这类白名单列,思路相同。
错误代码
public void updatePlateNo(Long vehicleId, String plateNo) {
// 错:没有按 vehicleId 先查出车辆档案,直接新建一个只填了部分字段的对象
VehiclePO po = new VehiclePO();
po.setId(vehicleId);
po.setPlateNo(plateNo);
po.setUpdateTime(new Date());
// 错:没有给 smartFlag 赋值,但它声明为基本类型 boolean,此刻已经是 false
// 错:整行更新会为每个字段生成赋值,smart_flag 被一起写成 0
vehicleMapper.updateAllColumns(po);
}
VehiclePO 是车辆档案的持久化对象,smartFlag 表示这辆车是不是智能车;vehicleMapper 负责把对象写回数据库。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
修复代码示例
public class VehiclePO {
private Long id;
private String plateNo;
// 改:状态类字段用包装类型,未赋值时是 null,可以表达“不修改”
private Boolean smartFlag;
private Date updateTime;
}
public void updatePlateNo(Long vehicleId, String plateNo) {
VehiclePO po = new VehiclePO();
po.setId(vehicleId);
po.setPlateNo(plateNo);
po.setUpdateTime(new Date());
// 改:更新语句只拼非 null 字段,smartFlag 为 null 时不会进入 set 子句
vehicleMapper.updateSelective(po);
}
updateSelective 的语义是“只更新对象里非 null 的字段”,所以只改车牌号时,智能车标识保持数据库原值。要把某辆车显式改成非智能车时,仍应在方法入参里明确传入 smartFlag,不要依赖默认值。
下次遇到这些场景要警惕
- 给“只改某一个字段”的需求加更新方法:先确认更新语句会不会写到其他字段。准备一辆智能车,只改车牌号执行一次,更新前后对比整行数据,确认只有车牌号和更新时间变了,而不是只看接口返回成功。
- 持久化对象用基本类型 boolean、int 表示业务状态:先确认这个字段在更新路径上是否可能“没赋值”。这类字段分不清“不修改”和“设为假”,局部更新场景要换成包装类型,并配合只更新非 null 字段的语句。
- 局部更新接口写完后:用字段缺省的请求实际执行一次,查数据库确认缺省字段保持原值;同时检查更新前后有没有对关键字段做变更比对,缺少比对时这类覆盖不会报错,只能靠回归发现。
- 影响已经落进数据时:按更新时间窗口加上关键字段的变化筛出受影响记录,逐条核对业务状态并恢复,不要只修代码就认为数据已经回来了。