发生了什么

企业客户在后台有一套账号体系:先有一份企业商户档案,档案上有一个企业商户编号(代码里叫 merchantId),这家企业名下的使用人账号都挂在这个编号下。运营在后台的“企业用户”页给某家企业新增使用人,页面顶部要先确定当前是哪家企业商户,页面上另有一个列表组件,负责按这个编号加载这家企业已有的人员。

正常流程分两步:页面组件在 created 阶段把企业商户编号写到自己的数据上;列表组件挂载完成时(mounted),用这个编号请求列表接口。接口要求编号必填,拿到编号后才返回该企业的人员列表,页面渲染出来,运营接着点新增。

6 月 5 日,有同事打开这个页面做新增企业用户的操作,页面弹出“企业商户 ID 不能为空”,列表也没有加载出来,新增做不下去。

这次和平时不同的地方,是页面 created 里多了一段埋点代码。为了统计页面使用情况,开发在 created 里、给编号赋值之前调用了取埋点参数的接口,并且用 await 等它返回,之后才把企业商户编号赋给页面。埋点接口平时返回很快,问题不容易出现;一旦它变慢,编号赋值就被推迟,而列表组件不会等它——页面照样往下渲染,列表组件挂载后照常发起列表请求,请求里的编号是空的,接口校验直接拒绝。

本质

一句话:埋点本来只做统计,却被放在业务赋值前面 await,把一次可选的慢请求变成了列表加载的前置条件。

  1. 页面渲染有固定顺序:父组件先执行 created,接着渲染子组件,子组件的 mounted 早于父组件的 mounted 执行。
  2. created 改成 async 后,框架拿到的只是一个 promise,不会等它完成再渲染;await 后面的语句被排到当前这一轮之后的微任务里。
  3. 于是页面在编号还没赋值时就完成了子组件的挂载,列表组件的 mounted 立刻执行 loadList,读到的 merchantId 是空串。
  4. 列表接口对编号做必填校验,空值直接被拒,页面把失败原因提示成“企业商户 ID 不能为空”。
  5. 埋点越慢,这段空窗期越长,越容易命中;所以它不是偶发的网络抖动,而是执行顺序问题被慢响应放大。

一段与业务无关的统计调用,只要排在赋值前面又被 await,就会变成业务能否正确执行的前置条件。

同类写法还有另一种表现:编号本身就是异步取回来的(等接口返回再赋值),而子组件在 mounted 里就去读。区别只在于等待发生在哪一层,结果都是子组件先跑、数据后到。

修复思路是把埋点挪到业务赋值之后,并且不再 await:编号先在 created 里同步赋值完成,埋点用 then 触发、catch 静默处理,慢或失败都不挡页面。问题单状态为已完成,没有给出修复后的验证数据。下面两段代码是按上述机制写的脱敏教学示例,只对比埋点与赋值的先后,不代表实际项目源码或已上线实现。

错误代码

// 页面(父组件):加了埋点后,赋值被 await 挡在后面
const EnterpriseUserPage = {
  data() {
    return { merchantId: '' };
  },
  async created() {
    // 为什么错:await 之后本函数立刻返回,后面的赋值被推迟到微任务
    await loadTrackingParams();
    // 为什么错:执行到这里时,子组件已经挂载并查过一次列表了
    this.merchantId = this.readMerchantId();
  }
};

// 列表组件(子组件):挂载后自动按 merchantId 拉数据
const UserList = {
  props: { merchantId: String },
  mounted() {
    this.loadList(); // 为什么错:此刻父组件还没赋值,merchantId 是空串
  },
  methods: {
    loadList() {
      return request('/user/list', { merchantId: this.merchantId }); // 空值被接口校验拒绝
    }
  }
};

修复代码示例

// 页面(父组件):先同步赋值,再在业务之后做不阻塞的埋点
const EnterpriseUserPage = {
  data() { return { merchantId: '' }; },
  created() {
    // 同步完成业务赋值,子组件挂载时一定能读到编号
    this.merchantId = this.readMerchantId();
    // 埋点不 await:失败或变慢都不影响页面加载
    loadTrackingParams()
      .then((params) => reportPageView(params))
      .catch(() => { /* 埋点异常静默处理,不打扰业务流程 */ });
  }
};

const UserList = {
  props: { merchantId: String },
  mounted() {
    this.loadList();
  },
  methods: {
    loadList() {
      if (!this.merchantId) return; // 兜底:编号未就绪就不发请求
      return request('/user/list', { merchantId: this.merchantId });
    }
  }
};

下次遇到这些场景要警惕

  1. 在 created、mounted 里新增埋点、日志或配置拉取时,先列出这段代码之后还有哪些赋值;如果它被 await,就用一个故意延迟几秒的返回把页面打开一次,观察子组件的第一个请求参数是否为空。
  2. 子组件在 mounted 里自动取数的,逐个确认它依赖的父级数据是同步赋值还是异步赋值;把父级接口延迟到秒级,看列表请求是否带空值,空值时有没有前置判断兜住。
  3. 页面首个请求的参数来自上一步赋值、上级页面或地址栏时,打开页面后先看网络面板里第一条列表请求的入参,再和页面顶部显示的商户对照;两者不一致就是时序问题,不要只看接口有没有报错。
  4. 埋点、统计这类与业务无关的调用,设计上就不该挡住业务:放在业务之后、不 await、异常单独 catch,并用断网或超时的方式验证一次,确认页面仍然能正常加载。