跳转到内容
搜索文档

故障排除

最后更新 查看 MarkdownAgent 设置

未启用调整大小的请求

响应是否包含 Cf-Resized 标头?如果没有,则未尝试调整大小。可能的原因:

  • 未在 Cloudflare 仪表板中启用该功能。
  • 同一请求上运行了另一个 Worker。一旦一个 Worker 调用另一个 Worker,调整大小就会被"遗忘"。请勿使用作用域为整个域名 /* 的 Workers。
  • Cloudflare 仪表板中 Editor 的预览不会模拟图像调整大小。您必须部署 Worker 并从另一个浏览器标签页进行测试。

调整大小返回的错误

调整大小失败时,响应体包含解释原因的错误消息,以及包含 err=codeCf-Resized 标头:

  • 9401 — {cf:image{…}} 选项中的必需参数缺失或无效。请重试。请参阅获取选项了解支持的参数。
  • 9402 — 图像太大或连接中断。请参阅支持的格式和限制了解更多信息。
  • 9403 — 发生请求循环,因为图像已被调整大小或 Worker 获取了自身的 URL。请验证 Worker 路径和服务器上的图像路径不重叠。
  • 9406 和 9419 — 图像 URL 是非 HTTPS URL,或 URL 包含空格或未转义的 Unicode。请检查 URL 并重试。
  • 9407 — 源站服务器域名发生查找错误。请检查 DNS 设置并重试。
  • 9404 — 源站服务器上不存在该图像,或用于调整图像大小的 URL 错误。请验证图像存在并检查 URL。
  • 9408 — 源站服务器返回 HTTP 4xx 状态码,可能拒绝访问图像。请确认图像设置并重试。
  • 9509 — 源站服务器返回 HTTP 5xx 状态码。这很可能是源站服务器端软件的问题,而非调整大小的问题。
  • 9412 — 源站服务器返回非图像内容,例如 HTML 页面。这通常发生在指定无效 URL 或服务器端软件打印错误或呈现登录页面时。
  • 9413 — 图像超过 100 兆像素的最大图像面积。请使用较小的图像并重试。
  • 9420 — 源站服务器重定向到无效 URL。请确认源站设置并重试。
  • 9421 — 源站服务器重定向次数过多。请确认源站设置并重试。
  • 9422 - 转换请求被拒绝,因为已达到用量限制。如需请求超过 5,000 次唯一转换,请升级到 Images Paid 计划。
  • 9432 — 使用旧版计费时 Images Binding 不可用。您的账户使用的是旧版 Image Resizing 订阅。要将 Images 绑定到 Worker,您需要在仪表板中将计划更新为 Images 订阅。
  • 9504、9505 和 9510 — 无法联系源站服务器,因为源站服务器可能已关闭或过载。请稍后重试。
  • 9523 — /cdn-cgi/image/ 调整大小服务无法执行调整大小。这可能发生在图像格式无效时。请使用格式正确的图像并重试。
  • 9524 — /cdn-cgi/image/ 调整大小服务无法执行调整大小。这可能发生在图像 URL 被 Worker 拦截时。作为替代方案,您可以在 Worker 内调整大小。这也可能发生在使用 Cloudflare Pages 项目的 pages.dev URL 时。在这种情况下,您可以使用自定义域名代替。
  • 9520 — 不支持该图像格式。请参阅支持的格式和限制了解支持的输入和输出格式。
  • 9522 — 图像超过处理限制。这在清除整个 zone 后或请求尺寸非常大的文件时可能短暂发生。如果问题持续存在,请联系支持。
  • 9529 - 图像处理超时。这可能发生在请求尺寸非常大的文件或服务器过载时。
  • 9424、9516、9517、9518 — 内部错误。如果遇到这些错误,请联系支持。

限制

以下限制适用于存储在 Images 之外的图像:

  • 最大图像大小为 100 兆像素(例如,10,000×10,000 像素)。最大文件大小为 100 兆字节(MB)。GIF/WebP 动画限制为总共 50 兆像素(所有帧大小之和)。
  • 优化远程图像(转换)时,Bring Your Own IP (BYOIP) 与 Images 不兼容。
  • Polish 无法优化图像时,响应标头返回 Warning: cf-images 299 "original is smaller"

对源站的图像请求将被匿名化(无 Cookie、无身份验证、无自定义标头)。这是因为我们必须为调整大小的图像拥有一个公共缓存,共享为个别访问者个性化的图像是不安全的。

但是,在客户同意在公共缓存中存储此类图像的情况下,Cloudflare 支持通过 Workers 在已认证的源站上调整图像大小。


缓存和清除

更改图像尺寸或其他调整大小选项始终立即生效——无需清除。

图像请求由两部分组成:运行 Worker 代码和图像处理。Worker 代码始终执行且不被缓存。如果源站服务器的 Cache-Control 标头允许,图像处理结果缓存一小时或更长时间。源图像使用常规缓存规则缓存。调整大小在内部遵循重定向,因此重定向也会被缓存。

由于 Workers 本身的响应不在边缘缓存,清除 Worker URL 没有任何效果。调整大小的图像变体一起缓存在其源 URL 下。清除时,使用(全尺寸)源图像的 URL,而不是请求调整大小的 Worker 的 URL。

如果源站服务器发送 Etag HTTP 标头,调整大小的图像将具有格式为 cf-<gibberish>:<原始图像的 etag>Etag HTTP 标头。您可以将第二部分与源图像 URL 的 Etag 标头进行比较,以检查调整大小的图像是否是最新的。

这篇文档对您有帮助吗?