发生了什么

这个 App 给一线运维人员使用,同一个 App 里按业务分成几个工作台:一个管换电,一个管两轮车。每个工作台是一个独立的前端工程,由一组 H5 页面组成。这些页面不直接跑在手机浏览器里,而是装在一个外壳中,外壳负责渲染页面,也负责把页面要用的原生能力转过去,其中就包括取当前登录凭证的 getToken。页面拿到凭证后带上它去请求后端,后端才知道这个请求是谁发的。正常情况下,进哪个工作台就用与它配套的那个外壳,取凭证一直能成,页面不会要求重新登录。

出问题的这轮改动,是把老外壳整体换成新外壳,先在换电这条业务上灰度。灰度是否命中,在进入换电工作台时判定一次,结论存在设备本地,之后再进页面会先读这份记录。两轮的人员管理、工单中心这些页面,当时仍然挂在换电那套老外壳上,没有跟着迁到新外壳。

现象出现在使用某个 iOS 版本的一线运维身上:他先打开换电工作台,命中了灰度,本地就记下“这台设备用新外壳”;接着打开两轮工作台,进人员管理或工单中心,页面在挑外壳时读到的是同一份记录,于是也被放进了新外壳。两套外壳提供的桥接能力并不一样,getToken 在新外壳里的表现与老外壳不同,页面仍然按老外壳的约定去取,拿不到可用的凭证,请求发出去后端认不出这个人,页面提示登录信息失效,人被退回登录页。灰度的入口只在换电,所以出问题的是先开换电、再开两轮的那批 iOS 运维,范围落在灰度覆盖的一批运营城市。

本质

登录系统本身没有出错。问题出在灰度结论:它被按设备缓存,又被另一个业务的前端工程拿去用了。

  1. 做外壳切换时,判定条件只写了“这个用户命不命中灰度”,没有写“是哪个前端工程在问”。命中与否本该是某个工程的事,实际被记成了整台设备的事。
  2. 结论落到本地存储时,键也只有一份,没有带工程名。先进入的工程算完写进去,后进入的工程不去分辨这是谁算的,直接读出来用。换电工作台先算,两轮工作台后读,一前一后就把结论串了过去。
  3. 两轮的人员管理、工单中心仍旧依赖老外壳的能力,这次迁移没有覆盖它们。页面没改,外壳换了,页面与外壳原来的配套关系就断了。
  4. 取凭证失败之后,页面没有区分“这个外壳不提供这个能力”和“用户真的没登录”,一律按未登录处理,于是把本来还能用的登录态清掉,直接退回登录页。

关键在第 2 步和第 4 步:灰度结论漏了工程维度,又被按设备共用,另一条业务线的页面进了不配套的新外壳,取不到凭证,登录态被当成失效。

止血是把外壳的灰度开关关掉,命中的设备回到老外壳。记录给出的后续方向是外壳统一交给两轮这边维护,并在切换外壳的方法里加过滤,只对换电前端工程生效;本地记录的键要不要一起按工程分开,记录没有提。这件事做到什么程度、是否验证过,现有信息也没有说明,修复上线状态待确认。

下面的代码是脱敏教学示例,用来解释这次错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 进入工作台时决定用哪个外壳,结论按设备缓存
function chooseContainer(projectId) {
  const cached = localStore.get('container_gray_result');
  if (cached !== null) {
    // 为什么错:缓存键没有工程维度,别的工程算出的结论也照用
    return cached;
  }
  // 为什么错:命中条件只看用户,没有限定前端工程
  const hit = gray.hit({ userId: session.userId });
  const result = hit ? 'new' : 'old';
  localStore.set('container_gray_result', result);
  return result;
}

// 页面统一从外壳取登录凭证
function buildAuthHeader() {
  // 为什么错:没有判断当前外壳是否提供该能力,取到空值也照发
  const token = containerBridge.call('getToken');
  return { Authorization: 'Bearer ' + token };
}

第一处错在判定条件只看用户,第二处错在本地只存一份结论,第三处错在取凭证时不看外壳有没有这个能力。三处叠在一起,页面才会在没坏掉的情况下被判定成未登录。

修复代码示例

// 只有换电前端工程参与外壳切换,其余工程一律留在老外壳
function chooseContainer(projectId) {
  const cacheKey = 'container_gray_result:' + projectId; // 结论按工程分开存
  const cached = localStore.get(cacheKey);
  if (cached !== null) {
    return cached;
  }
  if (projectId !== SWAP_PROJECT) {
    return 'old'; // 本次改动范围之外,保持原外壳
  }
  const hit = gray.hit({ userId: session.userId, projectId });
  const result = hit ? 'new' : 'old';
  localStore.set(cacheKey, result);
  return result;
}

// 取凭证前先确认当前外壳提供该能力,取不到就交回上层降级
function buildAuthHeader() {
  if (!containerBridge.supports('getToken')) {
    return null; // 不能当成用户退出登录,由上层切回老外壳
  }
  const token = containerBridge.call('getToken');
  return { Authorization: 'Bearer ' + token };
}

示例的改动只围绕两处:让结论和缓存都带上工程,本次范围外的工程直接留在老外壳;取凭证前先确认当前外壳提供该能力,取不到就交给上层切回老外壳,而不是当作用户退出登录。缓存键按工程拆开、桥接能力先探测,是顺着原因补的两处防线,不代表记录里的实际修复就是这样做的。

下次遇到这些场景要警惕

  • 给灰度或开关加判定时,先列出所有会读这份结论的前端工程和页面;在一台设备上先开 A 工作台再开 B 工作台,看 B 会不会被 A 的结论带走。
  • 灰度结论落到本地缓存时,检查缓存键有没有带工程或页面维度;换一个入口、换一个工程各打开一次,确认两次读的不是同一条记录。
  • 外壳、WebView 或桥接能力升级时,先盘出仍挂在老外壳上的页面清单,逐页在新外壳里走一遍取凭证和主要操作,不要只确认页面能打开。
  • 页面把桥接调用失败一律当未登录前,先分清是外壳没有这个能力,还是凭证真的过期;前者应回退老外壳或换路径,而不是清掉登录态。