一、先区分两类报错场景，处理逻辑不一样

WebP返回404分为源站侧问题、CDN侧问题，第一步一定要先测试源站直链：

• 场景1：源站直接打开WebP也是404
  根源：虚拟主机服务器缺少WebP对应的MIME映射，服务器无法识别该后缀资源，直接拦截返回404。
• 场景2：源站访问正常，CDN域名访问404
  根源：EdgeOne缓存了旧的404状态、回源HOST配置错误、缓存键规则异常、防盗链Referer校验拦截。

二、虚拟主机添加WebP MIME映射，修复源站404

多数虚拟主机面板默认没有WebP媒体类型，需要手动新增，IIS与Apache填写参数一致：

后缀名：.webp

MIME类型：image/webp

面板操作入口

• Windows IIS主机：主机控制面板 → 站点配置 → MIME类型 → 添加
• Apache主机：主机控制面板 → 伪静态/站点配置 → 媒体类型

提交后等待2至5分钟配置生效，优先测试源站图片链接，源站能正常打开，再去处理CDN配置。

三、EdgeOne CDN端核心配置检查

源站已经恢复正常，但CDN访问依旧404，优先核查下面三项设置：

1. 核对回源HOST头部

虚拟主机依靠绑定域名区分站点，回源HOST和绑定域名不一致，服务器无法匹配站点资源，直接404。

路径：EdgeOne控制台 → 站点管理 → 回源配置 → 回源HOST

设置值：填写当前站点绑定的主域名

2. 调整缓存键，避免404状态长期缓存

节点一旦缓存404响应，即使源站修好，访客依然拿到错误缓存。

• 缓存键只保留URL作为匹配依据，不要额外携带请求头、无关参数
• 关闭“缓存源站4xx状态码”选项，防止错误固化

3. 排查防盗链与Referer拦截

防盗链、URL鉴权、图片防护规则会拦截EdgeOne回源请求，返回伪装404。

排查方式：临时关闭CDN防盗链相关规则，测试图片是否恢复访问。

四、全局刷新CDN缓存，清除旧错误记录

EdgeOne节点分布范围广，会出现部分地区正常、部分地区404，需要主动刷新：

• 操作入口：缓存刷新功能，优先选择目录刷新，不需要逐个提交图片链接
• 提交后等待5至10分钟，全球节点逐步更新缓存

五、兼容兜底方案：WebP自动降级

老旧浏览器、部分客户端不支持WebP格式，可以借助EdgeOne边缘函数实现自动降级：

• 识别客户端Accept头部，判断浏览器是否支持WebP
• 不支持WebP的客户端，自动返回备用JPG/PNG原图
• 规避区域性图片裂开、加载空白问题，适合长期运营站点

六、标准排查顺序（建议按这个顺序操作）

1. 打开源站直链，确认问题归属源站还是CDN
2. 虚拟主机面板添加WebP的MIME类型
3. 检查并修正EdgeOne回源HOST、缓存键配置
4. 临时关闭防盗链，验证是否是拦截导致
5. 提交目录刷新，清理全网旧缓存
6. 有兼容需求时，配置边缘函数做图片降级兜底