发生了什么

商家端有一类面向用户的免押业务:商家在某个城市为某位用户开通“免押”,开通后这位用户在该城市使用服务不用先交押金。办理入口是一张“新增免押”页面,商家在里面选城市、填用户手机号,提交后系统为这个用户登记一条免押资格。

正常流程是:商家在一笔换电订单的详情页点“去免押”,页面带着订单里的用户和设备信息跳到新增免押页;页面打开时向后台拉一次配置数据,决定这一单能选哪些项、按什么规则配;商家选好城市、填完手机号,提交完成。

此前有一个问题:从订单页第二次点“去免押”进来时,页面没有重新拉配置,显示的是上一次留下的旧数据。原因是新增免押页被前端设成了常驻缓存的页面(keep-alive):组件被缓存后再次进入不再重新创建,进入时那次加载也就不会执行。为修这个问题,开发在离开新增免押页时把页面缓存清掉,让下一次进入一定是全新的实例、重新拉配置。

随后商家端反馈了新的现象:进入新增免押页填好手机号,再去点“选择城市”,从城市选择页返回时手机号已经空了,页面像刚打开的样子,没法接着提交,业务侧因此报障。

已确认的影响只在这一处:先填手机号再选城市,手机号会丢;反过来先选城市再填手机号,全程不发生页面切换,缓存不会被清,流程可以走完,主流程没有被完全卡死。

本质

一句话:清缓存的动作被绑在“离开页面”这个事件上,而“去选城市”同样是一次离开页面,流程内部的一次跳转被当成了流程结束。

  1. 缓存页的行为:组件被缓存后,第二次进入复用的是上一次的组件实例,创建阶段的加载逻辑不再执行,页面上仍是旧配置。这就是最初那个“配置数据不更新”。

  2. 当时的修法:在路由离开的钩子里把这张页面从缓存列表中移除。页面一离开,缓存即被丢弃,下次进入重新创建、重新拉配置。

  3. 没被考虑到的路径:新增免押页里的“选择城市”不是一个弹层,而是一个独立路由。点它就真的离开了新增免押页,钩子照常触发。

  4. 于是缓存在这一步被清掉。缓存带走的不只是那份配置数据,还包括页面实例上的表单状态,商家刚填的手机号随组件一起被销毁。

  5. 从城市选择页返回时,页面按“第一次进入”重新初始化,手机号自然是空的。清缓存的判断只看“有没有离开这个路由”,没看“离开之后还要不要回来”。

修复方向是把清缓存的时机从“离开页面”挪到“发起一次新的免押”这个业务动作上:商家在订单页点“去免押”按钮时清一次缓存,保证新的一单一定读到最新配置;页面内部再去选城市、返回列表,都不再清。这样改动只落在换电订单跳转新增免押这一条入口上,其他页面不受影响。这条修复是否已经发布、发布后是否验证通过,尚未确认。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 新增免押页:被 keep-alive 缓存,离开路由时把缓存清掉(脱敏教学示例)
const cachedViews = ['AddDepositFree'];

export default {
  name: 'AddDepositFree',
  data() {
    return { phone: '', cityCode: '', config: null };
  },
  created() {
    // 只在组件创建时拉一次配置;命中缓存再次进入不会执行
    this.loadConfig();
  },
  beforeRouteLeave(to, from, next) {
    // 为什么错:判断条件只有“离开了这个路由”。
    // 点“选择城市”跳去城市选择页也会走到这里,
    // 缓存连同已填的 phone 一起被清,返回时页面按首次进入重建
    const i = cachedViews.indexOf(this.$options.name);
    if (i > -1) cachedViews.splice(i, 1);
    next();
  },
  methods: {
    onPickCity() {
      this.$router.push({ name: 'CityPicker' });
    },
  },
};

修复代码示例

// 修复后:清缓存从“离开路由”挪到“发起一张新的免押单”时(脱敏教学示例)
const cachedViews = ['AddDepositFree'];

// 只有明确的业务动作才丢弃缓存,跳转本身不再触发
export function dropAddDepositFreeCache() {
  const i = cachedViews.indexOf('AddDepositFree');
  if (i > -1) cachedViews.splice(i, 1);
}

// 订单页“去免押”按钮:这一次点击代表要开一张新的免押单,
// 修复:只在这里清一次,保证新单拉到最新配置
export function onGoDepositFree(router, orderId) {
  dropAddDepositFreeCache();
  router.push({ name: 'AddDepositFree', query: { orderId } });
}

// 新增免押页里删掉 beforeRouteLeave 的清缓存逻辑:
// 去城市选择页属于流程内跳转,缓存和已填内容都要保留

下次遇到这些场景要警惕

  • 给页面加缓存、或加“离开就清缓存”的兜底时:先把这张页面上所有会发生的路由跳转列全,选城市、选网点、选设备、传证件逐条走一遍“填一半 → 跳出去 → 返回”,确认已填内容还在。
  • 确定缓存失效的触发点:挂在业务上真正“重新开始”的动作上(点去免押、点新增),不要挂在“路由变化”这类技术事件上;路由变化分不清“真的走掉”和“只是出去一下再回来”。
  • 修“页面数据不更新”时,回归范围要成对:既要验“再次进入是否拿到最新数据”,也要验“流程中途离开再回来,输入是否保留”。两条路径共用同一段缓存逻辑,只验一条必然漏掉另一条。
  • 代码评审(含自动评审)对清缓存改动提示过风险时:把风险落成具体操作再验证——谁在哪个页面、点了什么、期望看到什么,而不是只看评审结论有没有通过。