发生了什么
企业客户在后台有一套账号体系:先有一份企业商户档案,档案上有一个企业商户编号(代码里叫 merchantId),这家企业名下的使用人账号都挂在这个编号下。运营在后台的“企业用户”页给某家企业新增使用人,页面顶部要先确定当前是哪家企业商户,页面上另有一个列表组件,负责按这个编号加载这家企业已有的人员。
正常流程分两步:页面组件在 created 阶段把企业商户编号写到自己的数据上;列表组件挂载完成时(mounted),用这个编号请求列表接口。接口要求编号必填,拿到编号后才返回该企业的人员列表,页面渲染出来,运营接着点新增。
6 月 5 日,有同事打开这个页面做新增企业用户的操作,页面弹出“企业商户 ID 不能为空”,列表也没有加载出来,新增做不下去。
这次和平时不同的地方,是页面 created 里多了一段埋点代码。为了统计页面使用情况,开发在 created 里、给编号赋值之前调用了取埋点参数的接口,并且用 await 等它返回,之后才把企业商户编号赋给页面。埋点接口平时返回很快,问题不容易出现;一旦它变慢,编号赋值就被推迟,而列表组件不会等它——页面照样往下渲染,列表组件挂载后照常发起列表请求,请求里的编号是空的,接口校验直接拒绝。
本质
一句话:埋点本来只做统计,却被放在业务赋值前面 await,把一次可选的慢请求变成了列表加载的前置条件。
- 页面渲染有固定顺序:父组件先执行 created,接着渲染子组件,子组件的 mounted 早于父组件的 mounted 执行。
- created 改成 async 后,框架拿到的只是一个 promise,不会等它完成再渲染;await 后面的语句被排到当前这一轮之后的微任务里。
- 于是页面在编号还没赋值时就完成了子组件的挂载,列表组件的 mounted 立刻执行 loadList,读到的 merchantId 是空串。
- 列表接口对编号做必填校验,空值直接被拒,页面把失败原因提示成“企业商户 ID 不能为空”。
- 埋点越慢,这段空窗期越长,越容易命中;所以它不是偶发的网络抖动,而是执行顺序问题被慢响应放大。
一段与业务无关的统计调用,只要排在赋值前面又被 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 });
}
}
};
下次遇到这些场景要警惕
- 在 created、mounted 里新增埋点、日志或配置拉取时,先列出这段代码之后还有哪些赋值;如果它被 await,就用一个故意延迟几秒的返回把页面打开一次,观察子组件的第一个请求参数是否为空。
- 子组件在 mounted 里自动取数的,逐个确认它依赖的父级数据是同步赋值还是异步赋值;把父级接口延迟到秒级,看列表请求是否带空值,空值时有没有前置判断兜住。
- 页面首个请求的参数来自上一步赋值、上级页面或地址栏时,打开页面后先看网络面板里第一条列表请求的入参,再和页面顶部显示的商户对照;两者不一致就是时序问题,不要只看接口有没有报错。
- 埋点、统计这类与业务无关的调用,设计上就不该挡住业务:放在业务之后、不 await、异常单独 catch,并用断网或超时的方式验证一次,确认页面仍然能正常加载。