onerror直接写this.src='fallback.jpg'必然死循环,必须同时切断事件(this.onerror=null)、判别路径(如!this.src.includes('placeholder'))、用base64 SVG兜底确保零请求失败。

直接写 onerror="this.src='fallback.jpg'" 必然死循环——只要备用图也 404,浏览器就会无限重试、卡死标签页。真正能落地的方案,必须同时满足三件事:切断事件、判别路径、兜底可控。
onerror死循环的根本原因和触发条件
浏览器对 onerror 的响应非常机械:只要 src 发起的请求最终返回非 2xx 状态(如 404、403、跨域拒绝)、或解码失败,就触发一次;而你换新 src 后,它又发起一次请求——如果这次还失败,就再次触发。没有内置计数器,也不管你是不是已经换过三次。
常见触发死循环的写法:
-
onerror="this.src='logo-fallback.png'"(没切断) -
onerror="handleError(this)"中函数里只改src,没设this.onerror = null - 备用图路径写成
./fallback.png,但在子路由下实际请求的是/admin/./fallback.png,404 后继续循环
可靠防死循环的两种写法
必须让「换源」和「停用 onerror」原子性执行,顺序不能颠倒。推荐以下任一方式:
✅ 内联一行式(最稳,SSR 友好):![]()
✅ 动态绑定时加标记(适合 JS 创建的 img):
创建后立即绑定:
const img = document.createElement('img');<br>img.src = '/user/123.jpg';<br>img.addEventListener('error', function handler(e) {<br> if (e.target.dataset.retryCount === '2') {<br> e.target.src = 'data:image/svg+xml;base64,...';<br> e.target.removeEventListener('error', handler);<br> return;<br> }<br> e.target.dataset.retryCount = (parseInt(e.target.dataset.retryCount) || 0) + 1;<br> e.target.src = '/static/placeholder.svg';<br>});
为什么 base64 SVG 是 fallback 的最优解
相对路径、CDN 地址、甚至绝对路径的 fallback 图,都可能因部署结构、file:// 协议、代理配置或 CDN 缓存失效而二次 404。而内联 base64 SVG 不走网络请求,不解析路径,不触发 CORS,加载零失败率。
使用要点:
- 用最小可用尺寸,比如
width="30" height="30",base64 字符串控制在 200 字节内 - 避免在 base64 中嵌入外部引用(如
),否则仍会发请求 - 不要用工具“一键转 PNG 为 base64”——PNG 大小可能是 SVG 的 10 倍,且带透明通道易渲染异常;手写或用
更可靠
容易被忽略的三个关键点
很多团队写了防死循环,上线后还是出问题,往往栽在这三处:
- 动态插入的
img元素,onerror绑定必须在appendChild()之前,否则首次错误已发生,监听器完全收不到 -
中的不支持onerror,只有末尾那个标签才响应;所以 fallback 逻辑必须落在它身上,且它的src必须是真实可访问地址 - 服务端返回 200 状态码的兜底页(如 Nginx 配置了
try_files $uri /404.html;),onerror根本不会触发——此时只能靠alt或 CSS 背景图兜底,无法自动换源
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











