发生了什么

运营人员日常通过一套运营端 App 办理业务。这个 App 不是一个整页应用,而是由多个相互独立的页面拼起来,每个页面负责一类操作:任务处理、客服工具、批量业务操作等。用户先用账号登录一次,之后打开各个页面;页面每次向后端取数据、提交操作,都会带上登录时换来的凭证(token),后端靠这个凭证识别是谁在操作、登录是否还有效。正常时,凭证属于当前登录的用户,页面能正常打开和操作。

这次是另一回事:多条业务线的多个运营人员打开这些页面时,页面直接提示“登录信息已失效,请重新登录”。用户重新登录后,进去仍然提示失效,任务、客服、批量操作等多个入口一起打不开,不是某个账号或某台设备的问题。

排查后确认,问题来自当天这次页面发布。开发为了本地调试,曾把一份登录凭证直接写在代码里,这样起页面时不用反复登录就能调接口。这段调试代码没有被清理,跟正式改动一起提交并发布了。页面加载后拿到的凭证来源,从“当前用户登录得到的那个”变成了“代码里写死的这个固定值”。对每个真实用户来说,请求带的是一个跟自己登录会话对不上的凭证,后端校验不通过,就按登录失效处理,页面把用户挡回登录页。

记录里给出的处理结果是“已解决”,没有写明是回退版本,还是去掉写死凭证后重新发布,也没有记录验证过程,所以这里不判断是否已经彻底修复。

本质

正常流程有四步:

  1. 用户在运营端 App 登录,后端验证账号后发放一份登录凭证。
  2. 页面保存这份凭证,之后每次请求都带上它。
  3. 后端收到请求,用凭证找到对应的登录会话,确认是谁、有没有过期。
  4. 校验通过才返回业务数据,页面正常渲染。

发布出去的代码在这个链条之外插了一个替代来源:

  1. 调试期间,开发把一份凭证写成代码常量,页面启动时优先读这个常量,省掉本地登录。
  2. 提交代码时,这段调试分支没有被删掉,也没有被发布流程拦住。
  3. 页面发布后,所有用户加载到的都是同一份常量凭证。
  4. 用户发请求时带的是这份常量,而不是第 2 步里属于他自己的凭证;后端按它查会话,查不到或已过期,就返回登录失效。
  5. 这些页面共用同一段请求前置逻辑,或者读同一份启动配置,所以一处写死,所有依赖它的页面同时失效。

一句话:登录凭证被换成了与当前用户无关的固定值,所有页面的鉴权同时失效。问题不是会话到期,也不是后端校验变严,而是发布物里带进了一个本应只存在于开发者本地的凭证。

调试用的固定凭证一旦进入发布物,每个用户都会被当成“凭证不对”的人。

修复方向是把凭证来源改回当前登录会话,并在发布前加一道检查,把写死的凭证挡在发布物之外。代码为脱敏教学示例,用服务端下发页面启动配置的写法示意机制,不代表实际项目源码,也不代表已经上线的实现。

错误代码

// 给页面下发启动配置的接口(Java 教学示例)
@GetMapping("/page/bootstrap")
public Map<String, Object> bootstrap() {
    Map<String, Object> cfg = new HashMap<>();
    cfg.put("env", "prod");
    cfg.put("requestPrefix", "/api");
    // 为什么错:调试时为了免登录,把一份固定凭证写死在这里
    // 发布后所有用户拿到的都是同一个值,与自己的登录会话无关
    cfg.put("token", "FIXED_DEBUG_TOKEN");
    return cfg;
}

修复代码示例

@GetMapping("/page/bootstrap")
public Map<String, Object> bootstrap(HttpServletRequest request) {
    Map<String, Object> cfg = new HashMap<>();
    cfg.put("env", env());
    cfg.put("requestPrefix", "/api");
    // 按当前请求的登录会话取凭证,不再从代码常量里取
    String token = loginSession.currentToken(request);
    if (token == null || token.isEmpty()) {
        // 没有有效登录态就明确要求重新登录,不下发任何兜底凭证
        throw new NotLoginException("login required");
    }
    cfg.put("token", token);
    return cfg;
}

// 配套:发布前扫描变更与构建产物中的凭证字面量,命中即阻断(示意,未在原项目验证)

下次遇到这些场景要警惕

  • 改动里出现写死的凭证或调试账号:提交前在变更和构建产物里搜 token、密钥、固定账号这类字面量,命中就阻断发布,不要只靠评审时“看一眼”。
  • 为调试加过免登录、跳过校验的分支:合入前确认它只在本地开关下生效、线上开关默认关闭,并验证线上构建产物里不含这段分支或常量。
  • 多人同时反馈登录失效:先对齐发布批次和时间,抓一次页面请求,比对请求里的凭证与当前会话是不是同一份;如果所有人带的是同一个值,按发布问题排查,而不是逐个重置账号。
  • 修复或回滚之后:用不同业务线的账号分别登录,清掉浏览器缓存再进页面,确认请求带的是本人凭证、换账号后凭证随之变化,再看页面是否恢复。