onerror一写就卡死的根本原因是备用图也失败导致无限循环,必须用this.src='fallback'; this.onerror=null严格顺序防递归,推荐base64内联占位图确保兜底可靠。

onerror 为什么一写就卡死页面
根本原因不是代码写错了,而是浏览器对失败请求的响应机制:只要 src 加载失败(404、跨域拒绝、MIME 不匹配等),就会触发 onerror;如果换的新地址也失败,它会再次触发——没有自动终止逻辑,纯靠你手动掐断。
真实踩坑现象包括:DevTools 卡死、内存飙升、标签页无响应、甚至整个 Chrome 窗口假死。这不是小概率事件,而是只要备用图路径稍有偏差(比如本地开发用 file:// 协议、相对路径拼错、CDN 域名未配置 fallback)就必现。
- 只写
onerror="this.src='fallback.png'"→ 必然循环 - 写了
this.onerror=null但顺序错(比如放在换图之后两行)→ 仍可能执行两次 - 用
data-fallbacked打标但没在函数开头判断 → 标记无效,照样重入
最简可靠的内联写法(静态 HTML 场景)
适用于图标、头像、按钮等路径固定的图片,不依赖 JS 初始化,兼容 IE9+。
必须满足三个条件:赋值、清事件、防重复,三者缺一不可,且顺序不能变:
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
<img src="logo.webp"
onerror="if (!this.src.includes('fallback')) { this.src='/img/fallback.svg'; this.onerror=null; }"
alt="公司 Logo">
-
this.src.includes('fallback')是路径守门员,防止 CDN 备份图再失败时二次进入 -
this.onerror=null必须紧跟在this.src=...后面,中间不能换行或加其他语句 - 备用图优先用
data:image/svg+xml;base64,...内联 SVG,彻底绕过路径解析和跨域问题
动态插入图片时 onerror 绑定时机错误
用 document.createElement('img') 或框架(React/Vue)生成的图片,onerror 属性写在字符串里是无效的——因为元素还没插入 DOM,错误已在创建后立即发生,事件监听器根本没机会挂上。
正确做法是在 appendChild() 之前,用 addEventListener 显式绑定,并用 dataset 控制状态:
const img = document.createElement('img');
img.src = 'https://cdn.example.com/photo.jpg';
img.addEventListener('error', function handler(e) {
if (e.target.dataset.fallbacked) return;
e.target.dataset.fallbacked = 'true';
e.target.src = 'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzAiIGhlaWdodD0iMzAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgZmlsbD0iI2ZmZiIvPjwvc3ZnPg==';
});
- 不能用
onerror属性赋值,必须用addEventListener -
dataset.fallbacked比onerror=null更安全:避免因多次绑定导致事件残留 - 首次失败后直接切到 base64 占位图,不走网络请求,杜绝二次失败可能
为什么 里的 onerror 还是白屏
<picture></picture> 本身不触发 onerror,只有最终渲染的那个 <img alt="HTML标签onerror死循环怎么根治?清除循环报错处理流程" > 会。但很多人误以为 <source></source> 失败后会自动 fallback 到 <img alt="HTML标签onerror死循环怎么根治?清除循环报错处理流程" > 的 src——其实不会,<img alt="HTML标签onerror死循环怎么根治?清除循环报错处理流程" > 的 src 是独立加载的,它自己失败了,照样触发自己的 onerror。
所以关键点只有一个:<img alt="HTML标签onerror死循环怎么根治?清除循环报错处理流程" > 的 src 必须指向一个高可用地址,不能是相对路径、不能带查询参数、不能依赖后端路由 fallback。
- 错误写法:
<img src="logo.jpg?format=webp" alt="HTML标签onerror死循环怎么根治?清除循环报错处理流程" >→ 旧浏览器发请求,后端返回 406 或空内容,onerror触发但已晚 - 正确写法:
<img src="/static/logo-fallback.jpg" alt="HTML标签onerror死循环怎么根治?清除循环报错处理流程" >,且该路径在 Nginx/Apache 中配置为始终返回 200 + 可用图 - 更稳妥:
<img src="data:image/png;base64,iVBOR...>%EF%BC%8C%E5%AE%8C%E5%85%A8%E8%84%B1%E7%A6%BB%E6%9C%8D%E5%8A%A1%E7%AB%AF%E4%BE%9D%E8%B5%96 %0A


















