onerror 必须加 this.onerror=null 以防止备用图加载失败触发无限循环;可靠写法为 onerror="this.src='/static/ads/placeholder.png'; this.onerror=null;",且需用绝对路径或 base64 避免缓存与跨域问题。

onerror 是唯一能可靠触发图片 CDN 失效后降级的机制,但直接写 onerror="this.src='fallback.jpg'" 会陷入无限循环——备用图再失败,事件反复触发,浏览器卡死或白屏。
为什么 onerror 必须加 this.onerror=null
CDN 挂了,img 加载返回 404 或网络超时,触发 onerror;如果 fallback 图路径也是相对路径、或托管在同个失效 CDN 上,它也会失败,再次触发 onerror,形成死循环。浏览器不会自动终止。
可靠写法只有一种:onerror="this.src='/static/ads/placeholder.png'; this.onerror=null;"
- 分号不能省,否则第二条语句不执行
-
this.onerror=null必须紧接在src赋值之后,顺序颠倒就无效 - 绝对路径(以
/开头)或data:image/png;base64,...是最稳的选择,避开域名解析和跨域问题
本地备用图怎么放才不被缓存误伤
把 fallback 图放在自己域名下(比如 /static/fallback/)只是第一步。如果这个路径也被强缓存(如 Cache-Control: public, max-age=31536000),而你某天想换图,用户可能一年都看不到新版本。
立即学习“前端免费学习笔记(深入)”;
解决方法不是删缓存头,而是让 URL 变化:
- 构建时注入时间戳:
src="/static/fallback/404-button.png?v=20261010" - 用 Webpack/Vite 的
html-webpack-plugin自动替换,避免硬编码 - 若 fallback 图是 base64,它本身无缓存问题,但体积增大,适合小图标(≤ 2KB)
图片按钮失效时 alt 不是“替补”,是强制语义
很多人以为 alt 是加载失败才显示的文字,其实它是 img 标签的必需属性,且必须描述功能,不是装饰。
对带 onclick 的图片按钮,alt 写成 "按钮" 或留空,等于放弃可访问性与 SEO:
- 屏幕阅读器会跳过或读作“图像”,用户不知道能点什么
- 部分浏览器(如旧版 Safari)甚至拒绝渲染无
alt的img - 正确写法:
alt="删除当前项"、alt="展开详情面板"
注意:即使你用 onerror 换了图,alt 仍要保持语义一致——它定义的是“这个交互元素是什么”,不是“这张图长什么样”。
CDN 挂了,光换图还不够
换本地图只是视觉补救。真正危险的是静默故障:运营不知道广告位挂了,数据监控没报警,用户看到 placeholder 却没人跟进。
建议在 onerror 里加轻量上报:
onerror="this.src='/static/fallback/ads-728x90.png'; this.onerror=null; navigator.sendBeacon('/log/image-fail', JSON.stringify({src: this.src, ref: document.referrer}));"
这行代码不阻塞渲染,且即使页面即将卸载也能发出请求。关键是别只依赖前端日志——CDN 域名 DNS 解析失败时,onerror 根本不触发,得靠服务端日志或主动探测兜底。



















