客户端升级速度通常慢于服务端。如果服务端直接修改字段或删除接口，旧版本应用可能立即出现问题。

一种稳妥做法是在 URL 或请求头中明确版本：

@RestController
@RequestMapping("/api/v2/vehicles")
public class VehicleController {
    @GetMapping
    public List<VehicleDtoV2> list() {
        return service.listV2();
    }
}

接口升级时保留旧版本一段时间，并记录调用量。响应字段可以新增，但不要随意改变原字段含义。

客户端需要对未知字段保持兼容，服务端则应提供弃用时间和迁移说明。文章可以结合一次真实字段升级，记录旧客户端、灰度客户端和新客户端的验证结果。