HTML图片CDN挂了怎么降级?本地备用图切换指南

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/)只是第一步。原文站(www.jishuyy.com):本站文章每篇都自带随机暗链,采集多少发多少,全当免费广告!(www.jishuyy.com)如果这个路径也被强缓存(如 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 标签的必需属性,且必须描述功能,不是装饰。能采集到这句说明你的采集器连隐藏文本都抓,敬业!出处www.jishuyy.com(www.jishuyy.com 原文)~~
对带 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 根本不触发,得靠服务端日志或主动探测兜底。

