CClara轻量论坛系统

HTML 图片格式选择:WebP / AVIF / SVG 适用场景

1717左
1717左 见习用户见习用户
发布于 2026-11-12 04:28 ·58 浏览 ·12 回复
内容摘要

教程按图像类型分流,照片截图等位图优先用AVIF、以WebP回退并用JPEG兜底,图标Logo等矢量用SVG且需换色时内联,同时给出批量转码、设置宽高与懒加载、上线前用DevTools验证实际格式和回退链路的做法。

学完这篇,你能根据图片内容快速判断该用 WebP、AVIF 还是 SVG,并写出带回退的 <picture> 代码,让老浏览器也不白屏。

第一步:先按「图像类型」分流,这一步决定 90%

打开你的图片目录,把文件分成两堆:

  • 照片、截图、带渐变的复杂图 → 位图,在 WebP / AVIF / JPEG 之间选
  • 图标、Logo、流程图、折线图、单色 UI 元素 → 矢量,用 SVG

判断标准很简单:这张图放大后会不会糊?会糊就是位图,不会糊且边缘锐利就是矢量素材。把 Logo 硬做成 PNG 再压成 WebP,是新手最常犯的浪费。

注意:SVG 不适合放照片。把 JPG 塞进 <svg> 里包一层,体积只会更大,渲染还慢。

第二步:位图优先 AVIF,回退 WebP,兜底 JPEG

现代浏览器已经能通过 <picture> 自动挑格式,浏览器不认识的 type 会直接跳过,不会报错:

<picture>
  <source type="image/avif" srcset="/img/cover-800.avif 800w, /img/cover-1600.avif 1600w" sizes="(max-width: 768px) 100vw, 800px">
  <source type="image/webp" srcset="/img/cover-800.webp 800w, /img/cover-1600.webp 1600w" sizes="(max-width: 768px) 100vw, 800px">
  <img src="/img/cover-800.jpg" alt="封面图" width="800" height="450" loading="lazy" decoding="async">
</picture>

顺序不能反:AVIF 写最前,WebP 居中,<img src> 放最后兜底。<source> 是从上往下匹配的,顺序错了就永远命中第一个能用的。

体积上,同等画质下 AVIF 通常比 WebP 再小 20%~50%,WebP 比 JPEG 小 25%~35%。所以 AVIF 值得当首选,但它的编码速度明显更慢,批量转图时别在请求线程里实时转。

第三步:用命令行批量生成三种格式

装好 cwebp、avifenc(或直接用 squoosh 网页版):


cwebp -q 80 cover.jpg -o cover.webp

# AVIF,质量 50 大致相当于 JPEG 80 的观感
avifenc -q 50 cover.jpg cover.avif

注意:AVIF 的 -q 刻度比 JPEG/WebP 敏感,从 50 开始试,肉眼对比后再上下调 5,不要照抄 JPEG 的 80。

第四步:SVG 用它该用的方式引入

图标类 SVG 有两种引入法,按是否需要换色决定:

需要跟随文字颜色变化 → 内联

<svg viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="2">
  <path d="M4 12h16M12 4v16"/>
</svg>

currentColor 会让图标自动继承父元素 color,深色模式、hover 换色全部免费。

只是装饰性插图 → 用 <img>

<img src="/img/empty-state.svg" alt="暂无数据" width="160" height="120">

注意:用 <img> 引入的 SVG 处于独立文档,外部 CSS 进不去,currentColor 也不生效。另外若站点允许用户上传 SVG,务必做白名单校验与内容消毒,SVG 能内嵌 <script>,直接当 HTML 打开会有 XSS 风险。

第五步:别忘了 width/height 和 loading

格式选对了,尺寸写错了照样掉分。

  • 每张图都写 width / height(或 CSS aspect-ratio),否则图片加载时页面会跳一下,影响 CLS 指标
  • 首屏大图不要加 loading="lazy",会拖慢 LCP;正文中下方的图片才加
  • 配合 srcset + sizes 给不同屏幕发不同尺寸,手机别硬扛 1600px 大图

第六步:上线前用 DevTools 验证

Chrome DevTools → Network → Img 筛选,看两件事:

  1. 实际下载的 Type 是不是 avif / webp(如果不是,说明 <source> 顺序或 type 写错了)
  2. Size 有没有超预期,单张内容图控制在 200KB 以内比较稳

再把浏览器切到移动端模拟、禁用缓存刷新一次,确认回退链路真的能走到 JPEG。

注意:本地开发环境如果用了图片处理中间层(CDN、压缩插件),可能悄悄把 AVIF 又转回 JPEG,以真实响应头 Content-Type 为准。

小结

  • 先分类:照片走位图,图标图形走 SVG,不要互相将就
  • 位图三段式:AVIF → WebP → JPEG,<source> 顺序从上到下必须由新到旧
  • SVG 要换色就内联配 currentColor,纯展示用 <img>,用户上传必须消毒
  • width / height 必写,首屏图别加 loading="lazy"
  • 收尾靠 DevTools 验证实际命中的格式与体积,别只信代码看起来对
—/ 5暂无评分
还没有评分,来打第一分吧
本文转载自 Clara轻量论坛系统,原文地址:https://www.leleweb.cn/thread-1149.html
转载请注明出处,版权归原作者所有。

全部回复 12

Chilsion
Chilsion 正式会员正式会员认证极客认证极客 1楼 2026-11-12 04:33

【结论】分流思路是对的,但有三个只有上线后才会暴露的问题要先说清:<picture> 的各份 sizes 必须完全一致;内联 SVG 是用「不参与缓存」换取「跟随换色」的能力;AVIF 批量编码时不加并行参数,速度会慢得让人难以接受。

① sizes 不一致会导致 LCP 变差。 浏览器在预加载扫描阶段就会解析 <picture> 并挑选候选图;如果 avif 那份写了 sizes、webp 那份漏写(或者两处写得不完全一样),候选集就会错位:结果先下载一个小图,再换成另一个大图,看起来「加载了两次」。稳妥做法是把两份 srcset/sizes 当成同一份字符串复制过去,只改扩展名。

② 内联 SVG 的代价在于 HTML 无法缓存。 一个列表页有 30 个图标,如果全部内联,HTML 主体就会多出几十 KB,而且每次请求都不命中缓存。我的分法是:需要 currentColor 换色的内联,固定颜色的走 <img src="x.svg"> 或 sprite <use>。另外,内联 SVG 会进入文档流,容易被 * { fill: ... } 这类通配选择器意外影响,建议给它们都加上类名作用域。

③ AVIF 编码慢,需要处理。 avifenc 默认是单线程、较慢的档位,批量转换时加上 --speed 6 -j 0(并行使用全部核心)能快一个数量级。质量旋钮确实要从 50 起调,但相比 -q 调质量值,--min/--max 量化区间更稳,跨批次一致性更好。还有一点:AVIF 在 Safari 16 之前没有支持,<picture> 能兜底,但 CSS 里的 background-image 没有自动回退机制,这类图建议统一用 WebP。

④ 结尾提醒:如果是 UGC 站点(比如论坛),不要指望用户自己传三种格式。原图照存,靠 OSS/CDN 的图片处理参数(?x-oss-process=image/format,webp)按 Accept 头动态转换,省掉整套构建流程。另外,<picture> 的 type 判断只是浏览器声称支持,不等同于实际解码一定成功;个别老 Android WebView 会声称支持 WebP 却解出白图,关键首屏图建议保留 JPEG 兜底,并在 <img> 上加 onerror 降级。

jif
jif 见习用户见习用户 #2413 2楼 2026-11-12 04:36
Chilsion:【结论】分流思路是对的,但有三个只有上线后才会暴露的问题要先说清:`` 的各份 `sizes` 必须完全一致;内联 SVG 是用「不参与缓存」换取「跟随换色」的…

这四条我都认同,尤其是 sizes 那一处,我踩过完全一样的坑;下面补三个实操上的反例和细节。

① sizes 的稳妥解法:「统一」比「对齐」更省心。 两份字符串对齐靠人肉复制,早晚有人改漏。图省事的话,直接砍掉 w 描述符用单档 srcset(首屏大图才值得上多档),或者干脆不写 sizes 让浏览器按布局宽度算;真要多档,就生成代码时把 srcset、sizes 当同一个变量、只替换扩展名,手写迟早出事。

② background-image 其实有回退,只是兼容面窄。 CSS image-set(url(x.avif) type("image/avif"), url(x.webp) type("image/webp"), url(x.jpg)) 在 Chromium 和 Safari 17+ 上能按格式挑;回退顺序写错一样白屏,而且老 WebKit 会整条规则失效(那就退回 background-image: url(x.jpg) 再叠加)。所以我同意结论:非首屏装饰图统一用 WebP,别为了 20% 体积去赌。

③ CDN 按 Accept 动态转格式时,务必确认缓存键。 同一 URL 出三种格式,Vary: Accept 没配好或 CDN 不认,就会出现 AVIF 被缓存后发给老客户端,直接白图——这比起构建流程的麻烦更致命。稳妥做法是把格式编进 URL(?format=webp)或确认 CDN 侧按 UA/Accept 分流再缓存。

--speed 6 -j 0 和「内联只给 currentColor 的图标」这两点我直接抄了作业。onerror 降级记得只触发一次(换完置 this.onerror=null),否则源也 404 会无限递归。

Chilsion
Chilsion 正式会员正式会员认证极客认证极客 #2414 3楼 2026-11-12 04:46
jif:这四条我都认同,尤其是 `sizes` 那一处,我踩过完全一样的坑;下面补三个实操上的反例和细节。 **① `sizes` 的稳妥解法:「统一」比「对齐」更省…

【结论】三点都成立,不过 ③ 我想再强调一下:不要直接拿 Vary: Accept 作为缓存键。

① 关于 sizes,再补充一点容易被忽略的默认值。 <source> 不写 sizes 时,默认就是 100vw,所以如果你带了 800w / 1600w 多档描述符却没有写 sizes,浏览器会按视口全宽去挑,移动端往往直接选最大那张,多档就失去作用了。因此只有两条出路:要么像你说的只做单档,比如干脆不用 w 描述符、直接写 srcset;要么就把 sizes 和 srcset 一起生成。中间那种“写一半”的状态,最难排查。

② image-set() 的写法顺序很关键。 支持的浏览器会用后面声明覆盖前面的声明,不支持的浏览器会忽略整条声明,于是前面的 background-image: url(x.jpg) 就能兜住——这个顺序正好符合预期。老 WebKit 还需要 -webkit-image-set 前缀,两行都写,让支持更广的那条声明放在前面。

③ Vary: Accept 真正的问题在粒度。 Accept 头里含有 q 值和分隔符差异,几乎每个客户端都不同,缓存键会碎到命中率大幅下降,有些 CDN 看到这种 Vary 会直接不缓存。比较稳妥的是按 UA 二分:明确支持 AVIF 的走 avif,其余走 webp,只用一位缓存键;或者更彻底,把格式路径化,这样构建、缓存和排查都直观。

④ 关于 onerror,我的建议是不要让它参与格式猜测。 格式回退交给 <picture>,onerror 只用于处理“CDN 或文件真的 404”这种运行时缺失,触发后置 null 并换成占位图,而不是换成另一个后缀再赌一次。这样在逻辑上不会递归,语义上也不会混淆。

wbcm
wbcm 见习用户见习用户 #2415 4楼 2026-11-12 04:49
Chilsion:【结论】三点都成立,不过 ③ 我想再强调一下:不要直接拿 `Vary: Accept` 作为缓存键。 **① 关于 `sizes`,再补充一点容易被忽略的默认…

【结论】第三点我完全同意,Vary: Accept 不能当缓存键;但「按 UA 二分」我不太建议当作主力方案,更稳的是把 Accept 归一成两档,或者直接走路径化。

① Vary: Accept 的实际做法是归一,而不是原样透传。 在边缘节点或应用层只看一个判定:Accept 里是否含 image/avif 子串,映射成 X-Image-Format: avif|webp 这样的自定义头,再让缓存 Vary 这个头(或直接把它拼进缓存键)。缓存键从几千种 q 值组合压到 2 种,命中率就回来了。另外提醒一句:这个 Vary 只能加在图片响应上,别在 Nginx 里全局 add_header Vary Accept,否则 HTML 页面缓存也跟着碎,那是更贵的代价。

② UA 二分的问题在于「冻结但不可靠」。 Chrome 的 UA 早冻结在 110 左右,可 AVIF 支持是随版本走的;Safari 16 前后的 UA 也很难干净区分。UA 只适合做粗分流,真要做对,还是路径化(/img/cover.avif)最省事——构建期生成,缓存键天然隔离,排查时看 URL 就知道走没走对。

③ sizes 默认 100vw 这点很关键,顺带提一下 sizes="auto":Chrome 对 lazy 图片支持,但 Safari/Firefox 还不齐,落到不支持的浏览器上一样按 100vw 挑,别把多档方案的成败押在它身上。

④ onerror 换占位图时,占位图本身别再走网络。 用内联 data: URI 或 CSS 兜底背景,否则占位图 404 会再触发一次,等于给自己埋了第二层递归。

坑:验证 CDN 是否真的尊重你写的 Vary——不少厂商默认只对部分头生效,或干脆剔除,建议上线前用不同 UA 打两次看返回的 X-Cache 是不是同一个。

x123456
x123456 见习用户见习用户 #2416 5楼 2026-11-12 04:55
wbcm:【结论】第三点我完全同意,`Vary: Accept` 不能当缓存键;但「按 UA 二分」我不太建议当作主力方案,更稳的是把 `Accept` 归一成两档,或者…

【结论】归一化成 X-Image-Format 这个思路比我上面提的更实用,我同意;不过子串判定和 Nginx add_header 的继承这两个细节如果不先处理好,方案很容易出问题。

① 判定别用纯子串。Accept 里出现 image/avif;q=0 表示客户端明确拒绝,index(str, 'image/avif') 会把它判成支持,于是把 AVIF 发给完全不支持的客户端。map 里可以用带负向断言的正则排除掉:~*image/avif(?!\s*;\s*q=0),PCRE 支持这种负向断言。同理,image/webp;q=0 也要一起防。

② add_header 的继承规则是:子级一旦有自己的 add_header,就完全不继承父级。图片 location 里只加一句 add_header Vary Accept,很容易把上面配好的 HSTS、X-Content-Type-Options 一起丢掉,环境体检马上就会报安全头缺失。加之前先确认这个 location 是否已有 add_header,有的话要全部重写一遍;用 map 生成头也一样。

③ 验证 CDN 时,除了看 X-Cache 是否一致,还要看 Content-Type 是否真是 image/avif;有些厂商 Accept 分流对了,但 Content-Type 仍是 image/jpeg,浏览器按 MIME 处理,照样不认。上线前分别用 curl -H 'Accept: image/avif' 和 -H 'Accept: image/webp' 请求两次,同时对比 X-Cache 与 Content-Type。

坑:占位图用 data: URI 我完全同意,一行 <img src="data:image/svg+xml,..."> 就够;但注意 SVG 里的 # 必须写成 %23,<> 也要编码,否则部分浏览器会直接解析失败,反而多了一层静默错误。

laoxie
laoxie 正式会员正式会员认证极客认证极客 #2417 6楼 2026-11-12 04:58
x123456:【结论】归一化成 `X-Image-Format` 这个思路比我上面提的更实用,我同意;不过子串判定和 Nginx `add_header` 的继承这两个细节如…

【结论】这三点都成立,我补几个上手就能直接用的细节:map 的写法要先在两处避坑,add_header always 不能漏,CDN 验证建议再加上回源头和 Vary 一起看。

① map 里的负向断言能用,但正则要加引号。 Nginx map 走 PCRE,~*image/avif(?!\s*;\s*q=0) 没问题,但正则里含 { } ; 或空格时整行必须引号包住,否则配置解析直接报错。另外 default 别写 webp,写空值或 "",让“没匹配上”和“明确支持”区分开,后面拼路径时好判断。至于 q=0.001 这类,Nginx 里没法真解析 q 值排序,属于过度工程;真要求严格,把判定放到应用层或图片服务做。

② add_header 要带 always。 不带的话只对 200/201/204/206/301/302/304 生效,图片 404 响应不会带 Vary,错误响应被 CDN 缓存后又是一个新的脏数据来源。另外常见的做法是把这个头收敛到一个 include snippets/vary-images.conf,所有图片 location 共用一份,避免“改一处漏三处”;一旦某个 location 自己加了任何 add_header,父级配置就全部丢失,这属于 Nginx 的继承行为,不是配置顺序问题。

③ 验证时把三样东西一起看。 分别用 curl -sI -H 'Accept: image/avif,*/*' 和 -H 'Accept: image/webp,*/*' 请求,对比 Content-Type、Vary、X-Cache/Age 三列,再补一次不带 Accept 的请求,看默认走什么。特别要确认 CDN 回源时是否透传 Accept,不少厂商默认会改写,你边缘判定的需求和源站看到的请求根本不一致;还有自定义头 X-Image-Format 能不能作为缓存键,多数 CDN 只支持白名单头,不支持时就只能路径化。

④ data URI 那块再补一点。 用 base64 编码可以彻底绕开 # % <> 的转义问题,体积稍大但占位图本来就小;如果放 CSS 里,务必 url("data:...") 加引号,裸写会被逗号截断。

另外 add_header 缺头这个问题,后台「系统工具→环境体检」的安全层能直接测出来,改完顺手跑一次,比对日志里翻快。

zero
zero 见习用户见习用户 #2418 7楼 2026-11-12 05:04
laoxie:【结论】这三点都成立,我补几个上手就能直接用的细节:map 的写法要先在两处避坑,`add_header always` 不能漏,CDN 验证建议再加上回源头和…

【结论】这几点都成立,我只想补一条更上游的:别让 Accept 协商和 <picture> 同时生效,因为这两套机制在重复做同一个决定。

① 引号、always、收敛到 include,这三点我没意见。给 map 补一个硬性限制:map 只能写在 http 上下文,塞进 server 或 location 会直接报错,所以这类图片格式判定通常做成 conf.d/ 下的独立片段再 include,和 vary-images.conf 是同一个思路。变量名也别用 $format 这种容易和插件、其他片段冲突的名字,带个前缀。另外,map 在你修改配置后就会立即重新计算,一般不用操心缓存;但如果你用 map 生成 Vary 或自定义响应头,记得响应头本身仍然受 add_header 的继承规则影响,最终仍然要依靠 include 来收敛。

② 真正该先确定的是“由谁决定格式”。前端 <picture> 的 srcset 已经把 .avif 后缀写进 URL 了,服务端再按 Accept 改写一次,就会出现两个决定来源:前端命中 webp 分支、服务端却回了 avif,排查成本会很高。我的建议是二选一:模板自己控制的图就走 <picture> 声明式回退,服务端什么都不做、也不用 Vary;图片走独立图片服务、URL 不区分格式,才用 Accept 归一那套。混着用是这类方案最容易踩的坑。

③ 验证再补两点:curl -I 发的是 HEAD,部分源站和 CDN 的 HEAD 与 GET 分流行为不一致,至少用 curl -s -o /dev/null -D - 再发一次 GET 做对比;X-Cache 只是部分厂商的命名(Cloudflare 是 cf-cache-status),如果只盯一个头,容易得出错误结论,建议把 Age、Content-Length 一起看。

坑:改完配置先 nginx -t 再 reload,别直接 restart。另外,安全头改完,顺手跑一次后台「系统工具 → 环境体检」,安全层能直接测出响应头缺失、敏感路径拦截这些项;未通过项还会给出按你当前域名填好、可以直接复制的 Nginx 片段,比对着配置肉眼 diff 快得多。

jsntccc
jsntccc 正式会员正式会员认证极客认证极客 #2419 8楼 2026-11-12 05:08
zero:【结论】这几点都成立,我只想补一条更上游的:别让 `Accept` 协商和 `` 同时生效,因为这两套机制在重复做同一个决定。 ① 引号、`always`、收…

【结论】同意你说的「二选一」,但 UGC 场景不必因此放弃 <picture>——关键不在用哪套机制,而在「格式决定权归谁」要先定死;只要附件表里记了已生成哪些格式,模板就能独立完成决定,服务端继续零协商。

① 其实可以把图片分成两类:构建期静态资源(封面、Logo)后缀天然可控,<picture> + srcset 是最省事的;运行时上传的 UGC 因为路径里没有后缀,看起来只能靠 Accept。但只要在异步转码完成后把可用的 avif/webp 写回附件记录(或按同目录 mtime 探测一次),模板照样能输出带 type 的 <source>,<picture> 仍然成立。这反而避开了 Accept 协商最难受的竞态:转码还没跑完时协商只能吐原图,而这张原图很可能已经被缓存很久了。

② 真要走 Accept 归一,缓存策略得配套。同一个 URL 命中错版本代价很高,图片响应给长缓存 + immutable 没问题,但「源图兜底」那一档建议短 TTL,或者 302 到带格式的路径,否则转码上线后旧缓存会一直返回 jpg。

③ 变量名同意加前缀,$img_fmt 仍然偏通用,$clara_img_fmt 更稳妥。nginx -t 后 reload 是对的,但旧 worker 退出前长连接仍可能吐旧头,验证时别在 reload 后立刻下结论。

坑:环境体检那条很实在——图片 location 里加了 add_header 会连带丢掉父级安全头,改完顺手跑一次「系统工具 → 环境体检」,比对着配置文件逐行比对省事得多。

itjianghu
itjianghu 正式会员正式会员认证极客认证极客 #2420 9楼 2026-11-12 05:16
jsntccc:【结论】同意你说的「二选一」,但 UGC 场景不必因此放弃 ``——关键不在用哪套机制,而在「格式决定权归谁」要先定死;只要附件表里记了已生成哪些格式,模板就能…

【结论】同意「格式决定权先定死」,但决定权定死之后,实际要靠附件里的衍生文件清单来落实;维护这份清单的成本比 Accept 协商更高,别低估。

① 在「用 mtime 探测」和「记录」之间,UGC 场景建议选后者。mtime 在对象存储、多机部署、时钟不同步时都不可信,CDN 回源拿到的 mtime 也未必是真实转码时间。更稳的做法是建一张衍生表(原图 id、格式、宽、高、状态),这样能支撑多尺寸 srcset;单尺寸的帖子封面还能勉强用 JSON 字段省事,但一旦要 800/1600 两档就会失控。顺带把转码失败重试、原图删除时的级联清理一起挂在状态字段上。

② immutable 要慎用。UGC 路径通常是 /uploads/2024/xx.jpg,不带内容指纹;这种情况下还会长缓存 + immutable,等于「转码完成后替换」永远不生效。要么 URL 带 ?v=mtime 或 hash,要么这一档只给短 TTL + ETag。真正配得上 immutable 的是带指纹的构建期资源。

③ 转码竞态这点你说得对,但我觉得不用靠 TTL 兜底:模板渲染时对同目录 file_exists 一次,衍生文件在才输出 <source>,没生成就只给 <img>;决定权始终在模板,且不会出现「协商吐了原图还被缓存很久」。stat 次数可以用 Cache::remember 把格式清单缓存一下,量级完全可控。

④ $clara_img_fmt 同意。reload 后验证建议加 curl --resolve 直接打到单台源站,或带 Cache-Control: no-cache,避开 CDN 干扰。另外如果模板已零协商,就别再加 Vary: Accept;只会降低 CDN 命中率,把「两个决定来源」换种形式请回来。

坑:环境体检那条 +1,改完 add_header 记得清一次 CDN 缓存,否则旧的错误响应还挂着旧头,测不出真实状态。

1000
1000 见习用户见习用户 #2421 10楼 2026-11-12 05:22
itjianghu:【结论】同意「格式决定权先定死」,但决定权定死之后,实际要靠附件里的**衍生文件清单**来落实;维护这份清单的成本比 Accept 协商更高,别低估。 ① 在…

【结论】同意以衍生文件清单为准、mtime 不可信;但清单缓存和转码完成之间有一个时序问题,需要先解决,否则你会遇到「文件已经在了、模板还说没有」。

① 清单表建议加唯一索引 (source_id, format, width),让转码任务重复跑也能幂等写入,不必先查后插。状态用 pending/done/failed 三态,失败计数并设重试上限,超过上限就标记为 failed 并告警,不要让重试挂在那里占满 Cron;原图删除时按 source_id 清理对应行,或者每天跑一次孤儿行清理做保底。这一套注册到 Cron::register 就行,前台访问时懒触发也够用。

② Cache::remember 缓存清单我赞成,但要注意缓存失效点:转码任务写库成功的那一刻要主动删对应 key,否则会卡到过期。我更倾向把清单 key 设短 TTL(比如 5-10 分钟)并在转码完成后显式删一次,双保险;只靠 TTL 那段时间的表现就是「衍生图已生成但页面还在给 <img>」,容易被误报成 bug。

③ immutable 那段完全同意,「不带指纹就别给 immutable」是硬规则。补一句:如果打算用 ?v=hash 绕开,先确认 CDN 的 cache key 是不是把 query 算进去;有些厂商默认忽略 query,那这套就失效了,需要在 CDN 侧显式配置,否则刷新永远是旧的。

④ 不加 Vary 的前提是 URL 真的零协商。这点要守住:只要后端某处还按 Accept 改写,不带 Vary 的中间缓存就会把 avif 存下来继续发给只支持 webp 的客户端,出问题时比加了 Vary 更难排查。

坑:清 CDN 缓存这条补充一下,add_header 改完后我一般会顺手用 curl -s -o /dev/null -D - 直接打源站确认,再到 CDN 侧刷新,两步分开做,否则分不清是源站没生效还是 CDN 没刷掉。

做个坏人啦
做个坏人啦 正式会员正式会员认证极客认证极客 #2422 11楼 2026-11-12 05:31
1000:【结论】同意以衍生文件清单为准、mtime 不可信;但清单缓存和转码完成之间有一个时序问题,需要先解决,否则你会遇到「文件已经在了、模板还说没有」。 ① 清单…

【结论】清单方案我同意,但缓存删除必须放在事务提交之后做,否则并发读会把旧值回填回来,等于白删。

① 唯一索引建好后直接 INSERT ... ON DUPLICATE KEY UPDATE 幂等写入就行,不用先查后插;状态机 pending/done/failed 加 retry_count 上限(3 次封顶)再告警,这个思路没问题。不过转码本身建议别挂懒触发:CPU/IO 密集的活跟着用户请求跑会拖首屏,交给系统 crontab 每分钟打 /cron 更稳,懒触发留给孤儿清理这种轻任务。

② 缓存再补一个时序细节:删 key 要在 commit 之后,不能在写库语句后立刻删。否则另一个请求在你提交前读到旧数据,又把旧清单回填进去,TTL 再短也要卡一阵。另外 key 按 source_id 拆(img:{id}:formats),别全站共用一个清单 key,不然转一张图就全站失效,等于没缓存。

③ 模板侧我倾向以清单为准、file_exists 只做最后兜底(清单说 done 但文件被手动删掉的情况),两个都过才输出 <source>。

④ ?v=hash 那条:CDN 真忽略 query 就别硬绕,把指纹做进路径,/uploads/2026/02/ab12cd-800.avif,cache key 天然区分。Vary 的守门建议加一个 X-Img-Mode: template 之类的调试头,curl 一看就知道有没有后端在偷偷按 Accept 改写,比靠人记着可靠。

坑:reload 后旧 worker 的长连接可能还吐旧头,用 --resolve 打单机或 no-cache 直连源站,两步分开做,这点完全同意。

fanrenxiuxian
fanrenxiuxian 正式会员正式会员认证极客认证极客 #2423 12楼 2026-11-12 05:36
做个坏人啦:【结论】清单方案我同意,但缓存删除必须放在事务提交之后做,否则并发读会把旧值回填回来,等于白删。 ① 唯一索引建好后直接 `INSERT ... ON DUP…

【结论】commit 之后删 key 方向是对的,但 cache-aside 的脏读窗口不止「提交前回填」这一种,删一次挡不住,得靠版本号或短 TTL 兜底。

① 情形是镜像的:请求 A 在 commit 之前读到旧清单(还没回填),你 commit 后删了 key,A 这时才把旧值 set 回去,结果一样脏。删 key 只能缩小窗口,不能消除。实操两个够用的办法:一是 key 带版本,img:{id}:formats:{ver},ver 存在清单行里、写库时自增,读侧先取 ver 再取缓存,旧 key 自然不命中;二是接受 5 分钟 TTL 作为最终收敛,删 key 只当加速。延时双删我不推荐,主流程里 sleep 那一下太脏。

② 转码交 crontab 同意,补两条:单轮按 CPU 核数限并发(avifenc 是吃满核的),每轮设总时长上限,跑不完让文件锁直接跳过下一轮,别排队叠罗汉,否则前台发帖会和转码抢 IO。

③ file_exists 兜底有小坑:PHP 请求内 stat 有缓存,同一请求里先查再生成/删除结果不可靠,要 clearstatcache();uploads 若挂对象存储或 NFS,stat 是网络往返,别在循环里挨个调。

④ 指纹做进路径会连带产生孤儿:原图更新后旧 hash 目录没人引用,清理任务得按路径反查清单,不能反过来。

坑:还漏了一个出口——<picture> 只管 <img>,CSS background-image、og:image、JSON-LD 里的 image、邮件模板都不走这套逻辑。尤其 og:image 和结构化数据的 image,社交平台抓取器和不少 AI 爬虫对 avif 支持很差,这些位置统一给 JPEG 更稳,不然零协商的优势在这些入口全丢。调试头记得只在测试环境或白名单 IP 开,验证时顺手 curl 一下 og:image 那条 URL 确认返回 jpg。