性能监控上线两周,CLS 面板一条数据都没有,均值一直是 0。同批用户的 LCP 和 INP 都有数,唯独这一项是空的。我先怀疑采样率,从 10% 调到 100%,第二天看还是 0。
翻 SDK 源码才发现,采集代码只在页面加载时注册了一次 layout-shift,回调里直接累加 value,从没算过会话窗口。更糟的是页面切到后台时没有 flush,数据停在内存里,跟着页面一起没了。
先补 flush。监听 visibilitychange,state 是 hidden 时把当前值发出去,用 sendBeacon 避免请求被中断。上线后数据终于有了,但比 Lighthouse 高出三倍,0.18 对 0.06,明显不对。
原因在累加方式。CLS 不是把整页偏移加起来,而是按会话窗口分段,间隔超过 1 秒或者单个窗口超过 5 秒就重开,最后取最大那个。我原来的写法等于全加,长页面必然偏大。
let cls = 0, win = 0, first = 0, last = 0;
new PerformanceObserver((list) => {
for (const e of list.getEntries()) {
if (e.hadRecentInput) continue;
if (e.startTime - last > 1000 ||
e.startTime - first > 5000) {
win = 0; first = e.startTime;
}
win += e.value; last = e.startTime;
cls = Math.max(cls, win);
}
}).observe({ type: 'layout-shift', buffered: true });
按规范重写,本地跑同一份 trace,SDK 算出 0.058,Lighthouse 是 0.06,差 0.002。再把 hadRecentInput 的判断补上,用户点击后 500 毫秒内的偏移不计入,数值才真正对齐。
还有个坑是 iframe。主页面注册的 observer 看不到跨域 iframe 里的偏移,嵌入的广告位抖动全漏掉,而那正好是最该监控的部分。这块只能让 iframe 自己上报,主页面用 postMessage 汇总。
上线一周,CLS 的 P75 是 0.04,和 CrUX 的 0.05 接近。回头看问题不在采样率,在于把指标定义想当然了。现在这段采集有单测,构造三段间隔不同的偏移,断言结果等于规范值,改一次跑一遍。
