发生了什么

服务站是平台上提供租车服务的线下门店,业务上按商户管理。用户到店后,商户在后台替用户办理取车。租车订单记录谁租车、租到什么时候、现在处于待取车还是已取车;车辆是一台具体的车。商户办理取车时,系统要把这份订单和一台车关联起来,也就是把车辆编号写到订单上,这个动作调用的接口叫“订单绑定车辆”。关联成功了,订单才算落到车上,商户才能把车交给用户。

正常流程是:用户到店 → 商户在后台找到订单、选择车辆 → 系统调用订单绑定车辆接口,把订单和车辆关联 → 商户把车交付出去。这个接口不只服务某一版业务:最早一批服务站订单里根本没有“车架号”这个字段,办理取车时不采集车架号;后来新做的服务站业务要求登记车架号,关联车辆时必须带上。两套业务走的是同一个绑定接口。

这次改动来自新版业务的测试。开发在测试时发现,绑定车辆接口在车架号传空值时也能成功,判断这是历史遗留的校验缺失,就在接口里补了一条“车架号不能为空”的判断。改动生效后,那批没有车架号的早期订单在商户端办理取车时被这条校验挡住,页面报“车架号不能为空”,订单无法关联车辆,取车做不下去。

本质

一句话:车架号是不是必填,取决于这张订单属于哪套业务;这次改动把一套业务的新要求,写成了所有订单共同的规则。

  1. 订单绑定车辆接口同时服务早期服务站订单和新版服务站订单。早期订单里没有车架号字段,传空值是这套业务的正常输入;新版订单则要求必须登记车架号。
  2. 新版业务测试时看到“车架号为空也能绑定成功”,把它理解成接口缺少校验,而没有先确认另一种可能:早期业务本来就没有这个字段,空值是设计如此。
  3. 开发于是在共享接口上加了一条无条件的非空判断。这条判断对“该传车架号的订单”是对的,对“没有车架号概念的订单”是错的,而接口本身没有区分两者的条件。
  4. 商户端办理取车时,早期订单按老规矩不传车架号,请求进入绑定接口,撞上新加的非空判断,接口抛出“车架号不能为空”,订单与车辆的关联没有写进去。
  5. 关联这一步失败后,取车没有可继续的路径,商户端看到的就是取车操作做不了。坏掉的是这一类订单的取车入口,不是某一条订单的数据写错了。

把一套业务的新规则加到两套业务共用的接口上,另一套业务会在自己完全合法的输入上失败。

记录里这个问题标为“已解决”,但没有写改成了什么、怎么验证,修复上线状态待确认。修复方向是:把车架号必填的判断收窄到需要车架号的订单,按订单所属的业务版本或订单类型区分,早期订单继续按原规则关联车辆;同时在接口说明和调用方清单里写清哪些业务必须传车架号,避免下一个人再把它当成历史缺陷。

下面两段 Java 是脱敏教学示例,只对比这条校验放在哪里,不代表实际项目源码或已上线实现。

错误代码

// 订单绑定车辆:早期服务站订单和新版服务站订单共用这个入口
public void bindVehicle(String orderNo, String vehicleNo, String vin) {
    // 为什么错:车架号必填只是新版业务的要求,这里却对所有订单无条件生效
    if (StringUtils.isBlank(vin)) {
        throw new BizException("车架号不能为空");
    }
    Order order = orderRepository.getByOrderNo(orderNo);
    if (order == null) {
        throw new BizException("订单不存在");
    }
    // 早期订单没有车架号字段,走到这里之前就已经被上面的判断拦下了
    order.setVehicleNo(vehicleNo);
    order.setVin(vin);
    orderRepository.update(order);
}

修复代码示例

public void bindVehicle(String orderNo, String vehicleNo, String vin) {
    Order order = orderRepository.getByOrderNo(orderNo);
    if (order == null) {
        throw new BizException("订单不存在");
    }
    // 车架号是否必填由订单所属业务版本决定,不再由接口一刀切
    if (order.isVinRequired() && StringUtils.isBlank(vin)) {
        throw new BizException("车架号不能为空");
    }
    order.setVehicleNo(vehicleNo);
    if (StringUtils.isNotBlank(vin)) {
        order.setVin(vin);   // 早期订单没有这个字段,空值不写入
    }
    orderRepository.update(order);
}

下次遇到这些场景要警惕

  • 给公共接口加必填校验前:先按业务版本列出所有调用方,逐个确认这个字段对它们是否本来就可以为空;再用“老业务不传这个字段”的请求跑一遍,观察是照常成功,还是被新校验挡住。
  • 测试时看到某个字段为空也能通过:先查这个字段在各套业务里的定义,分清“该拦没拦”和“本来就没有这个概念”,再决定加不加校验,不要直接把正常输入当成历史缺陷。
  • 改完共用接口后:不要只跑新业务的用例。用早期业务完整走一遍取车,从选车到关联结果都看到,而不是只看接口有没有返回成功。
  • 确实要区分两套业务时:把差异做成显式的业务版本或订单类型判断,并写进接口说明;不要依赖“调用方都会传这个字段”的假设。