必须确保src指向真实可用资源(如1px gif、lqip图或ssr小图),data-src静态写在html中,首屏图禁用lazy,内联intersectionobserver降级脚本,并避免display:none等css陷阱。

loading="lazy" 不支持时图片直接白屏怎么办
浏览器不识别 loading="lazy" 时,它不会报错,也不会读取 data-src,只会按默认逻辑加载 src。如果此时 src 是空、#、占位图路径错误或压根没写,结果就是白屏——不是“懒加载没生效”,而是降级链断了。
必须让 DOM 始终处于可运行状态:
-
src必须指向一个真实可用资源:1px GIF、内联 SVG 占位图(如data:image/svg+xml;base64,PHN2Zy...))、LQIP 图,或 SSR 渲染出的小图;绝不能留空或写src="#" -
data-src存高清图地址,且必须在 HTML 源码中静态存在(不能靠 JS 动态写入),否则断网时 JS 加载失败,data-src就彻底丢失 - 首屏关键图(如商品主图、头图)跳过懒加载:直接写死
src,不加loading="lazy",也不设data-src
IntersectionObserver 初始化必须内联,不能依赖外部 JS
把懒加载逻辑全塞进外部 JS 文件,等于把图片加载权交给网络——JS 请求失败,图片一张都不加载。尤其在弱网、拦截器或企业内网环境下,app.js 加载失败是常态。
正确做法是把核心初始化代码内联进 <script></script> 标签:
<script>
if ('IntersectionObserver' in window) {
const observer = new IntersectionObserver((entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
const img = entry.target;
img.src = img.dataset.src;
observer.unobserve(img);
}
});
});
document.querySelectorAll('img[data-src]').forEach(img => observer.observe(img));
} else {
// 降级兜底:立刻加载所有 data-src 图片
document.querySelectorAll('img[data-src]').forEach(img => {
img.src = img.dataset.src;
});
}
</script>
注意:else 分支不是摆设——它在 Safari ≤15.3、微信 X5、旧 Android WebView 等场景下必然执行,必须保证这段逻辑能跑通。
常见 CSS 陷阱会让懒加载“静默失效”
很多团队花力气写 JS 降级,却忘了样式层也能让懒加载彻底失能:
- 用
display: none隐藏图片容器?Safari 和多数 Android WebView 会直接跳过该<img>,即使后来display改成block,也不会重新触发加载 - 用
opacity: 0或visibility: hidden没问题,但若 JS 因断网没执行,CSS 动画就不会启动,用户看到的就是空白块 - 没设宽高或
aspect-ratio?会导致布局抖动,且部分老浏览器无法正确计算视口相交,IntersectionObserver可能永远不触发
建议所有懒加载图片都显式声明 width 和 height,或使用 aspect-ratio: 4/3 配合 object-fit。
onerror 不是 loading="lazy" 的替代 fallback
onerror 只响应“请求发出后失败”(如 404、网络中断),对以下情况完全静默:
-
src=""或src=" ":根本没发请求 - 跨域图片没加
crossorigin,被 CORS 拦截(控制台报错,但onerror不触发) - 服务器返回占位图(HTTP 200),浏览器认为“加载成功”
所以不要指望 <img onerror="this.src='/placeholder.svg'"> 能兜住 loading="lazy" 失效的问题。它只管单张图的网络异常,不管整个降级策略是否成立。
真正容易被忽略的是:首屏关键图必须绕过所有懒加载机制,直接渲染;而 JS 降级逻辑本身,必须在 HTML 解析阶段就准备好,不能等 DOMContentLoaded 或异步脚本。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











