预加载本身不改变缓存行为,必须与缓存策略协同:href须匹配最终URL,Cache-Control需允许复用(如public, max-age=31536000, immutable),避免no-cache或Set-Cookie导致预加载失效。

预加载本身不改变缓存行为,但必须和缓存策略协同,否则可能白忙一场——比如 preload 了,却因 Cache-Control: no-cache 被强制重请求;或缓存过期了,preload 又没带版本号,导致用旧图。
preload 的 href 必须匹配缓存资源的最终 URL
浏览器按完整 URL 缓存资源,href 写错一个字符、少个斜杠、多层相对路径,都会生成新缓存条目。常见错误:
-
href="./images/logo.webp"在/user/profile.html下解析为/user/images/logo.webp,但实际资源在/assets/logo.webp—— 结果 404 或缓存未命中 -
href="/images/logo.webp?v=1.2"和真实响应头Cache-Control: max-age=31536000冲突:带查询参数的 URL 默认不被强缓存(尤其 CDN 可能忽略 query) - WebP fallback 用
<picture></picture>时,preload只能声明其中一种格式(如logo.webp),但若用户设备不支持 WebP,浏览器仍会发新请求取logo.png,而这个 PNG 并未被预加载
Cache-Control 要允许复用,且优先级高于 preload
preload 是“提前发起请求”,不是“强制写入缓存”。如果服务器返回 Cache-Control: no-store 或 max-age=0,浏览器不会缓存该响应,下次 <img src="..." alt="HTML预加载图片怎么配合缓存使用" > 仍会重新请求——preload 只是白跑一次网络。
- 静态图片建议设为
Cache-Control: public, max-age=31536000, immutable(一年 + 不可变),这样 preload 后的响应能被长期复用 - 若资源会更新(如头像),改用文件名哈希(
avatar.a1b2c3.jpg)+immutable,比依赖max-age更可靠 - Safari 对
immutable支持较晚(2026 年已稳定),但即使不支持,max-age=31536000也足够覆盖大部分场景
new Image() 预加载时,缓存由 HTTP 头决定,但需手动处理 complete 状态
用 new Image() 发起的请求走的是浏览器标准资源缓存流程,但容易忽略一个关键点:缓存命中的图片,onload 不触发,img.complete 为 true。如果不检查它,就会卡在等待回调,以为加载失败。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- 必须先绑定
onload/onerror,再赋值src;否则缓存命中时事件同步发生,回调来不及注册 - 赋值
src后立即检查img.complete:为true就立刻执行成功逻辑,别等事件 - 如果后端返回
304 Not Modified(协商缓存),浏览器内部仍算“已加载”,complete也为true,无需额外处理
CDN 和中间代理可能绕过你设的缓存头
你在 Nginx 写了 expires 1y,但 CDN(如 Cloudflare)或企业防火墙可能覆盖响应头,导致实际缓存时间远小于预期。验证方式很直接:
- 打开 Chrome DevTools → Network → 找到预加载的图片 → 看 Headers 标签页里的
Cache-Control和Age - 如果
Age值很大(比如 86400),说明 CDN 确实缓存了;如果Age: 0且X-Cache: MISS,就是没缓存住 - 某些 CDN 默认不缓存带 query 参数的 URL(如
logo.webp?t=123),这类动态 href 会彻底失效
最易被忽略的一点:preload 声明的资源,如果服务端返回了 Set-Cookie,浏览器会拒绝缓存它——哪怕你写了 public, max-age=31536000。图片接口绝不能塞 Set-Cookie,这是硬性限制。


















