活动页引入一个新的图表库,本地正常,预发环境偶发报 undefined。连刷十次能出三次,控制台指向业务代码里调用构造函数的那一行,说它不是函数。把脚本挪到 body 末尾就正常,说明是执行顺序的问题。
页面里有三个脚本:框架、图表库、业务入口。框架和图表库都加了 defer,入口是普通 sCript 放在 head,靠 DOMContentLoaded 启动。按规范 defer 应该按文档顺序执行,可抓到的顺序是入口先跑,图表库后到,差了 500 毫秒。
第一反应是给入口也加 defer。报错没了,但首屏白屏从 1.1 秒涨到 1.6 秒,因为入口要等前面两个都下载完,而图表库在 CDN 上偶发要 800 毫秒才回。
换成 ES module 加 import,构建工具把依赖打进同一个 chunk,顺序由 import 保证。代价是首屏多一个 40KB 公共包,还要改构建配置,这个交换我觉得不划算。
<!-- preload 只下载,不进 defer 队列 -->
<link rel="preload" as="script" href="chart.js">
<!-- modulepreload 才会跟依赖图绑定 -->
<link rel="modulepreload" href="chart.js">
<script src="app.js" defer></script>
真正的原因藏得更深,是 head 里那条 preload。为了提速,我给图表库加了 rel=preload as=script,浏览器把它当高优先级资源提前下载。但 preload 只负责下载,不参与 defer 队列排序,下载完就插进执行栈,恰好抢在 defer 前面。删掉这条,十次刷新全部正常。
替代方案是 modulepreload,它跟 module 的依赖图绑定,能提前下载又不打乱顺序。加上之后图表库的资源开始时间提前了 180 毫秒,顺序也没再乱过。
验证方法很土但有效。在每个脚本第一行打一条带 performance.now 的日志,连刷二十次数先后,顺序稳定之后再打开 Performance 面板看资源开始时间,确认是真的提前下载,而不是只改了写法。
