必须在onerror中设置this.onerror=null以防止无限循环,且需紧接this.src赋值后;推荐使用data:image/svg+xml;base64内联占位图彻底规避路径与格式风险。

onerror里换图不加this.onerror=null必然循环
格式错误(比如把logo.webp当logo.png传,或服务端返回了HTML页面而非图片)会触发onerror,但若新src也出错——比如备用图路径写成fallback.jpg却实际是fallback.svg,或路径拼错导致404——浏览器会再次触发同一onerror,形成无限加载-失败-再加载链。内存飙升、标签页无响应是典型表现。
必须写成:onerror="this.src='/assets/placeholder.svg'; this.onerror=null;"。注意两点:this.onerror=null不能省略,且必须紧接在this.src=...之后(分号分隔),顺序颠倒就无效。
更稳妥的写法是加路径判断:onerror="if (!this.src.includes('placeholder')) { this.src = '/assets/placeholder.svg'; this.onerror = null; }",避免 fallback 图自己也失效时二次进入逻辑。
onerror不响应格式错误?其实是触发了但你没看到
onerror对格式错误是响应的:JPEG头损坏、WebP被当PNG解析失败、AVIF在不支持浏览器中加载后解码崩溃——这些都会让img.naturalWidth === 0并最终触发onerror(前提是请求发出去且返回非200或无法解码)。但很多人误以为“没触发”,是因为:
- 备用图路径本身又出错,浏览器静默阻止第二次
onerror调用(规范行为,不是bug) -
src写的是相对路径如./img/icon.webp,而当前页面URL带查询参数,导致base URL解析错乱,第一次就404 - 用了
srcset或picture,但onerror只绑定在上,而真正失败的是某个,它不冒泡也不触发该事件
验证是否真触发:在onerror里加console.log('fired', this.src),打开DevTools看输出;别只靠“图有没有换”来判断。
用data:image/svg+xml;base64,...彻底绕过路径风险
格式错误兜底最稳的方式,不是换另一个HTTP资源,而是直接内联一个不可能出错的占位图。SVG base64体积小、无需网络请求、无MIME协商、不依赖服务器配置。
示例:onerror="this.src='data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzAiIGhlaWdodD0iMzAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgZmlsbD0iI2ZmZiIvPjwvc3ZnPg=='; this.onerror=null;"
好处:
- 完全规避404、CORS、Content-Type不匹配、CDN缓存污染等所有路径相关问题
- 比HTTP fallback快一个RTT,首屏更稳
- 可预设语义化颜色或文字(比如灰色方块+“图不可用”文字),比纯白背景更友好
注意:base64字符串需URL-safe(不含换行、空格),生成后建议用encodeURIComponent再校验一次。
动态插入的![]()
必须提前绑定onerror
用document.createElement('img')创建后,再appendChild(),最后才img.onerror = ...——大概率来不及。DOM插入瞬间,浏览器已发起请求,失败事件在JS绑定前就已抛出,onerror永远收不到。
正确做法只有两种:
- 创建后立即赋值:
const img = document.createElement('img'); img.onerror = () => { img.src = 'data:image/svg+xml;base64,...'; img.onerror = null; }; img.src = brokenUrl; - 全局捕获(推荐):
document.addEventListener('error', e => { if (e.target instanceof HTMLImageElement && !e.target.dataset.handled) { e.target.dataset.handled = '1'; e.target.src = 'data:image/svg+xml;base64,...'; } }, true);——true启用捕获阶段,确保能截获所有后续插入的
SSR场景下,服务端输出的HTML必须自带内联onerror,否则首屏图片失败时JS还没执行,兜底就断档。
格式错误的兜底难点不在“怎么换图”,而在“换的那张图自己必须100%可靠”。路径、协议、MIME、CORS、动态时机——任何一个环节松动,整个降级链就断。base64占位图不是“退而求其次”,而是把最不可控的外部依赖,变成可控的内联常量。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











