发生了什么

这段业务是用户扫码租用两轮车。小程序里有一个「控车页」:用户从租车订单进入租车首页,再点进控车详情页,能看到当前这辆车的信息,并做开锁、锁车等操作。控车页打开时会调一个查询接口,请求里既带车辆编号,也带客户端版本号;服务端按版本号判断这个客户端该怎么响应,版本对不上就不返回数据。

这个租车页面不是独立打包的,它嵌在另一个业务(上门维修)的小程序工程里统一构建。用户平时从维修小程序首页下方的租车订单快捷模块点进来,先到租车首页,再进控车详情页。也就是说,租车页面的启动代码和那批公共依赖包是一起加载的,先跑谁由维修侧的入口文件决定。

正常情况是:页面启动时先按租车自己的参数初始化共享配置(版本号等),再加载其他公共包;公共包看到配置已经初始化过,就直接复用,不再初始化一遍。控车页发请求时取到的是租车自己的版本号,服务端版本判断通过,页面正常展示。

这次维修业务做了一次技术改造,从原生容器迁到 H5,构建时要把租车业务剥离出去,改造中调整了 SDK 的初始化调用顺序。上线后,控车页从 9 月 5 日起零星落到「开小差」报错页,9 月 7 日报错告警变得频繁。按接口日志统计,报错的查询接口覆盖 517 名用户,其中 515 人当时有进行中订单,涉及 540 个订单、510 辆车(智能车 456 辆、非智能车 54 辆);其中 6 名用户做了回访,期间没有客诉,也没有资金损失。

处置是 9 月 7 日晚上回滚微信端、支付宝端的这次发布,并把租车在这两个端的初始化流程提前到入口第一行。

本质

一句话:共享配置只允许初始化一次,谁先初始化就按谁的参数走;这次改造让公共依赖包抢在租车前面初始化了它,租车要传的参数没写进去,控车页请求带的版本号落到兜底值 1.0.0,被服务端的版本判断挡下来。

  1. 共享配置模块是单例,初始化时加一把锁:第一次调用写入参数,之后每次调用都直接返回。

  2. 租车页面依赖 5 个公共包,这些包彼此耦合引用,每个包在模块加载时都会顺带初始化一次共享配置。谁先被加载,这次初始化就归谁完成。

  3. 租车业务需要传自己的参数,版本号就在其中,所以必须由租车自己先初始化。它没有「被别的包初始化之后还能补参数」的能力。

  4. 改造调整初始化顺序后,公共包先被加载,共享配置先被初始化并上锁。租车随后调用的初始化被锁挡下,参数被静默丢弃,调用方拿不到任何失败信号。

  5. 控车页发请求时,版本号取自这份共享配置。参数没写进去,取到的是兜底值 1.0.0;服务端的版本判断认为这是不认识的旧版本,接口报错,页面落到报错页。

只有微信端、支付宝端出问题,是因为这两个端由维修侧工程构建,共用同一套初始化配置;H5 端从别的入口直接跳出去,不经过这段初始化。

修复方向是:把租车自己的初始化提到入口第一个被求值的位置,排在所有公共包之前;共享配置在重复初始化且参数不一致时直接报错,而不是静默返回;请求侧在版本号为空时不再退回兜底值。回滚和顺序调整已经执行,长期是否改成「参数可覆盖」或「每个业务各持一份配置」,记录没有写,不能算已经根治。

共享单例的初始化不是某个业务的私事:谁先初始化,后面所有人的参数就都跟着谁走。

错误代码

示例按记录给出的机制写:入口先加载公共包,共享配置被抢先后上锁,控车页取到兜底版本号。

// app.js:公共包先加载,租车的初始化排在后面(脱敏教学示例)
import './pkg/shared-config-consumer';   // 为什么错:模块加载时就初始化共享配置并上锁
import { initConfig } from './sdk/config';
import { RENTAL_VERSION } from './sdk/env';
initConfig({ version: RENTAL_VERSION });  // 为什么错:轮到它时锁已建,参数被丢弃

// sdk/config.js:共享配置只允许初始化一次
let inited = false;
const config = { version: '1.0.0' };      // 兜底值:参数没写进来时就用它

export function initConfig(params) {
  if (inited) return config;              // 为什么错:静默返回,调用方以为参数已生效
  inited = true;
  Object.assign(config, params);
  return config;
}

// page/control.js:控车页的版本号取自这份共享配置
export function queryBikeDetail(bikeNo) {
  // 为什么错:初始化没跑到租车自己的参数,这里带出去的是兜底 1.0.0
  return request('/rental/bike/detail', { bikeNo, version: config.version });
}

记录只写到「版本传 1.0.0」,没说明兜底值定义在哪一层;示例中的 config、initConfig 与接口路径均为示意。

修复代码示例

// 修复:新增一个只做初始化的模块,让入口第一个 import 它(脱敏教学示例)
// bootstrap/rental-init.js
import { initConfig } from '../sdk/config';
import { RENTAL_VERSION } from '../sdk/env';
initConfig({ version: RENTAL_VERSION });  // 修复:第一个被求值,参数先于公共包写入

// app.js
import './bootstrap/rental-init';         // 修复:排在所有公共包之前,初始化不再被抢
import './pkg/shared-config-consumer';

// sdk/config.js:重复初始化且参数不一致时不再静默
export function initConfig(params) {
  if (inited) {
    if (config.version !== params.version) {
      // 修复:冲突直接暴露,让「参数没生效」在启动阶段就报出来
      throw new Error('shared config already initialized: ' + config.version);
    }
    return config;
  }
  inited = true;
  Object.assign(config, params);
  return config;
}

改动落在两处:入口的求值顺序,以及初始化被重复调用时的处理方式。示例保留了原有的锁语义,只把「静默返回」换成「参数不一致就报错」;请求侧是否还要在版本号为空时拒绝发送,取决于这条链路是否允许降级访问,记录没有给出结论。

下次遇到这些场景要警惕

  • 调整多端共用工程的入口或初始化顺序时:先列出所有依赖这份共享配置的业务,再逐个走一遍各自入口,确认每个业务自己的初始化都排在第一个公共包之前被求值。
  • 给共享配置加「只初始化一次」的锁时:让重复调用带上参数比对,不一致就报错或告警;否则第二个调用方会一直以为自己的参数生效了。
  • 发布到多个端时:分别在每个端打开依赖共享配置的页面,对比接口请求里版本号的分布,确认没有出现兜底值,而不是只看页面能不能打开。
  • 服务端按版本号做判断时:让客户端在版本号为空或为兜底值时上报配置来源,这样「真的旧客户端」和「配置没注入」才能区分开。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名、接口路径与版本号均为示意。