发生了什么

两轮租车是 App 里让用户租用两轮车辆的业务。用户在订单页能看到自己正在进行的订单,也能在这个页面点免押继续办理。这些页面不打在 App 的原生代码里,而是跑在一个页面容器中:容器由客户端在启动时注册,注册完成后,它提供的页面才会以「路由」的形式出现在平台的路由表里,各入口按名字去打开。

正常流程是:用户从用车入口点租车,App 把租车页面的路由名交给路由系统,路由系统在路由表里按名字查到这条路由,打开页面;进了页面再点订单、点免押,同样按路由跳转,每一步都能看到页面切换。

这一次,一位用户在自己的客户端上点订单记录,没有任何反应,也没有跳到订单详情;同一个页面点免押,同样没有反应。录屏里点击之后画面停在原地,既没有加载态,也没有报错提示,看起来像整页卡死。随后换多个机型、多次尝试复现「卡死」,都没有成功。

从这位用户的客户端版本查下去,问题落在容器注册上:容器是某个客户端大版本才开始在启动时注册的,低于这个版本的安装包里没有这段注册逻辑,容器不存在,它提供的路由也就没有进路由表。用户点击时,路由系统按名字找不到路由,既不提示,也没有把失败交回发起跳转的页面,点击就变成了什么也没有发生。近一个月里,低于该版本的客户端占比约为 iOS 0.8%、Android 0.6%,这部分用户从用车入口进不了租车模块。

处理方案是对低于该版本的客户端弹窗提示升级,让用户升级后再办理;该方案的实施与上线状态待确认。生产环境和测试环境都没有再复现同一现象,问题仍在跟踪中。

本质

一句话:跳转依赖的容器在低版本客户端里从来没有注册,路由表里没有这条路由,而路由系统查不到路由时既不报错也不提示,用户看到的只有「点了没反应」。

  1. 容器注册是客户端启动时按版本执行的一步。当前安装包的版本达到门槛,才会执行注册,把容器的路由写进路由表;低于门槛的安装包里这段代码根本不存在,不是注册失败,而是从未发生。
  2. 页面上的订单、免押这些入口不直接打开目标页,而是把目标路由名交给平台路由系统,由它在路由表里按名字查。这一步的前提,是这台机器上的客户端确实注册过对应容器。
  3. 在低版本客户端上,路由表里没有租车模块的路由,按名字查不到任何结果。
  4. 路由系统对这种「查不到」没有把失败交回发起跳转的页面:既没有提示,也没有让页面进入任何失败分支。页面既不跳转,也不进入加载态,更不会报错。
  5. 用户侧因此只剩一种可见结果:点击后界面毫无变化。它和真正的卡死在表现上几乎一样,所以第一轮排查会先往卡死、性能方向走;而未注册属于能力缺失,日志里同样没有痕迹。

版本门槛造成的能力缺失是静默的:不报错、不提示、也不写日志,只有换成低版本客户端真机点一次,才看得出入口是坏的。

修复方向是把「查不到」变成可处理的结果:低版本客户端不注册容器时,登记一条明确的能力不可用说明;路由查不到时按原因给出升级提示或降级入口,并上报一次缺失记录。比起只在低版本上弹一个升级弹窗,这一步能让所有走同一路由的入口都有反馈,而不必逐个入口补提示。

下面两段 Java 是脱敏教学示例,只对比路由注册与查不到路由时的处理差异,不代表实际项目源码或已上线实现。

错误代码

// 客户端启动时注册页面容器;点击入口时按路由名跳转(教学示例)
public void registerContainerIfSupported() {
    if (appVersion.compareTo(CONTAINER_MIN_VERSION) < 0) {
        // 为什么错:低版本直接跳过注册,容器和它的路由从此都不在路由表里
        return;
    }
    containerRegistry.register(ContainerSpec.of("rental"));
}

public void openRoute(String routeName) {
    Route route = routeTable.get(routeName);
    if (route == null) {
        // 为什么错:查不到路由时静默返回,调用方和用户都收不到任何失败信号
        return;
    }
    route.open();
}

修复代码示例

public void registerContainerIfSupported() {
    if (appVersion.compareTo(CONTAINER_MIN_VERSION) < 0) {
        // 修复:旧版本仍不注册容器,但要留下“能力不可用”的原因
        containerRegistry.markUnavailable("rental", UnavailableReason.VERSION_TOO_LOW);
        return;
    }
    containerRegistry.register(ContainerSpec.of("rental"));
}

public void openRoute(String routeName) {
    Route route = routeTable.get(routeName);
    if (route == null) {
        // 修复:查不到路由时按原因给出提示,不再静默返回
        UnavailableReason reason = containerRegistry.unavailableReason(routeName);
        if (reason == UnavailableReason.VERSION_TOO_LOW) {
            ui.showUpgradeDialog("当前版本暂不支持该功能,请升级后使用");
        } else {
            ui.toast("页面暂时打不开,请稍后重试");
        }
        routeReporter.reportMissing(routeName, appVersion);
        return;
    }
    route.open();
}

下次遇到这些场景要警惕

  • 业务模块接入新容器或新能力时:先确认这套能力在声明支持的最低客户端版本上会不会注册。装一个最低版本的包,从入口点进去,观察是打开页面还是毫无反应。
  • 页面出现「点了没反应」的入口时:先查点击之后路由查找有没有失败结果,再怀疑卡死或性能。看路由系统对「查不到」是否返回了错误码、是否有提示、是否有上报。
  • 给能力加版本门槛时:把「低于门槛怎么办」当成需求的一部分。用低版本客户端走一遍入口,检查是否有升级提示或降级入口,而不是静默不可用。
  • 做入口跳转的版本兼容回归时:不要只在自己手上的最新版本点通一遍,按版本分布挑仍在用的低版本机型实测,断言「点击后有响应」,而不是只看有没有崩溃。