17370845950

本文介绍如何通过 `wp_get_attachment_image_src` 过滤器，精准替换首页 featured image（特色图像）的 `.webp` 图片 url 为 `.jpg`，解决 `the_content` 过滤器对缩略图无效的问题。

WordPress 默认使用 WebP 格式可提升加载性能，但在某些 CDN、旧版浏览器或缓存环境下，WebP 图片可能无法正常显示。你已成功用 the_content 过滤器处理文章正文中的 标签，但首页通过 wp_get_attachment_image_src() 获取的缩略图 URL 并未被该过滤器捕获——因为该函数直接返回数组形式的图片信息（含 URL），不经过 HTML 渲染流程，因此 the_content 完全不生效。

正确方案是挂钩 wp_get_attachment_image_src 过滤器，它在返回缩略图 URL 前触发，且接收完整数组 $image = [ $url, $width, $height, $is_intermediate ]。只需修改其中 $url 字段即可：

✅ 优势说明：

• 全局生效：所有调用 wp_get_attachment_image_src() 的地方（如 get_the_post_thumbnail_url()、the_post_thumbnail() 内部）均受控；
• 安全可靠：仅替换 URL 字符串，不影响尺寸、缩略图裁剪逻辑或响应式 srcset；
• 无侵入性：无需修改主题模板中 标签的输出逻辑，保持代码解耦。

⚠️ 注意事项：

• 确保目标服务器/CDN 存在对应 .jpg 文件（例如 /uploads/2025/05/photo.webp → /uploads/2025/05/photo.jpg），否则将返回 404；
• 若需更智能的降级（如存在 .jpg 才替换，否则保留 .webp），建议结合 file_exists() 或 wp_remote_head() 检查，但会增加开销，生产环境慎用；
• 如使用了图片优化插件（如 Smush、ShortPixel），请确认其是否已提供“WebP 回退”选项，优先使用插件原生功能以保障兼容性。

最后，将上述代码添加至当前主题的 functions.php 文件或自定义插件中，并清除对象缓存（如有），即可立即生效。