onerror无限循环的根源是事件链未切断,唯一可靠解法是赋值新src后立即执行this.onerror=null;备用图404、相对路径解析失败、CORS阻塞等均会导致降级失效。

onerror 无限循环不是代码写错了,是事件链没切断——只要备用图也 404,浏览器就会反复加载、失败、触发、再加载,直到卡死或崩溃。唯一可靠解法:赋值新 src 后**立刻执行 this.onerror = null**,且顺序不能颠倒、分号不能省。
onerror="this.src='fallback.png'" 为什么必卡死?
这是最典型的死循环诱因。浏览器行为是:加载失败 → 触发 onerror → 执行 this.src=... → 发起新请求 → 若新地址仍 404 → 再次触发 onerror → 循环开始。它不区分“是不是第一次”,只看加载结果。
- 相对路径(如
./fallback.png)在不同 base URL 下极易解析成 404 - CDN 地址拼错、节点故障、路径大小写不一致(
IMG.JPG≠img.jpg)都会让备用图失效 -
alt属性完全不参与加载流程,写得再全也防不住白屏
正确写法必须包含三要素:新 src + this.onerror=null + 可达兜底
缺一不可。推荐用绝对路径或 base64 SVG,彻底规避路径解析风险。
- 静态 HTML 推荐:
onerror="this.src='/assets/placeholder.svg'; this.onerror=null;" - 更防错的写法(避免重复降级):
onerror="if (!this.dataset.loaded) { this.dataset.loaded = '1'; this.src = '/fallback.svg'; } this.onerror=null;" - base64 SVG 示例(无网络依赖):
onerror="this.src='data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzAiIGhlaWdodD0iMzAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgZmlsbD0iI2ZmZiIvPjwvc3ZnPg=='; this.onerror=null;"
动态创建的 ![]()
怎么安全绑定 onerror?
JS 创建后先 appendChild 再补 onerror,大概率来不及——错误在插入 DOM 瞬间就已触发,事件直接丢失。
- 必须在插入前绑定:
const img = new Image(); img.onerror = () => { img.src = '/fallback.svg'; img.onerror = null; }; img.src = url; container.appendChild(img); - 全局捕获更省心(尤其大量动态图):
document.addEventListener('error', e => { if (e.target.tagName === 'IMG' && !e.target.dataset.handled) { e.target.dataset.handled = '1'; e.target.src = 'data:image/svg+xml;base64,...'; } }, true);—— 注意第三个参数true是捕获阶段,否则监听不到 - 别信
addEventListener('error')在上直接绑定,Safari 和旧 Edge 基本不支持
哪些情况 onerror 根本不会触发?别白忙活
很多“图片没显示”根本进不了 onerror,查半天代码不如先看 Network 面板。
-
src为空、空格、undefined:浏览器不发请求,无事件 - CORS 阻塞(外链图床未加
crossorigin):控制台报Blocked by CORS policy,但onerror不触发 - 服务器返回 200 状态码的占位页(如某些 CDN 的“图片不存在”HTML):浏览器视为成功,不走
onerror - file:// 协议下双击打开 HTML:所有资源请求被浏览器拦截,报
net::ERR_FILE_NOT_FOUND,这不是 JS 能解决的
真正难处理的不是怎么写 onerror,而是怎么确认备用图本身一定可达——本地开发时路径看着对,部署后可能因构建目录、CDN 缓存、大小写规则全崩。每次改完,务必在 Network 面板里点开那条红色请求,看 Request URL 到底发去了哪。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











