og:image 不显示？如何修复

og:image 不显示几乎总是由以下五个原因之一导致：图片 URL 不公开、图片过大、平台缓存了旧版本、标签指向了错误的页面，或图片格式不受支持。本指南将结合 Facebook、X 和 LinkedIn 提供的调试工具，逐一介绍每种修复方法。

为什么我的 og:image 不显示？

大多数情况下，图片 URL 无法被公开抓取、文件超出平台限制，或者平台显示的是缓存副本。社交平台会按计划重新抓取并积极缓存，因此新图片通常看起来“不生效”，直到你使用它们的调试工具强制刷新。

最常见的五个原因（及解决方法）

1. 图片 URL 未公开

平台必须无需认证即可获取图片。位于登录、localhost 或 IP 地址后面的 URL 将无法获取。

解决方法： 将图片托管在公开的 HTTPS URL 上，并确认 curl -I <image-url> 返回 200 OK，且带有图片 Content-Type。

2. 图片过大

大多数平台将 OG 图片限制在 8 MB（X 约为 5 MB）。巨大的 PNG 会静默失败。

解决方法： 将文件保持在 5 MB 以下；1200×630 的文字卡片通常为 200–500 KB。在 FastOG 上，PNG 输出已为此调整好大小。

3. 平台缓存了旧版本

Facebook、X、LinkedIn、Slack 和 Discord 都会积极缓存。Meta 还会存储自己的图片副本，并根据页面 URL 来生成预览，因此仅更换图片 URL 不会更新预览。更改图片后，旧卡片会持续显示数小时或数天。

解决方法： 使用平台的工具强制重新抓取（见下文）。对于需要更换图片的情况，请使用随内容变化的 URL（FastOG 的签名 URL 会自动实现这一点）。对于允许编程刷新的平台，请参阅强制刷新 Facebook Open Graph 缓存。

4. URL 错误或页面错误

og:image 标签可能缺失、重复，或指向没有该标签的页面。

解决方法： 查看页面源代码，确认 og:image 标签存在、由服务器端渲染，并且是绝对路径。

5. 不支持的格式

某些平台会拒绝特定格式或动画图片。

解决方法： 使用 PNG 或 JPG；1200×630 是受支持的宽高比。

调试工具

平台	工具
Facebook / WhatsApp	Sharing Debugger — `developers.facebook.com/tools/debug`
X / Twitter	Card Validator — `cards-dev.twitter.com/validator`
LinkedIn	Post Inspector — `linkedin.com/post-inspector`

请粘贴 URL，然后点击“Scrape”/“Refresh”以拉取最新的标签。

FastOG 特有说明

FastOG 渲染 1200×630 PNG（受支持的尺寸），因此可避免尺寸/比例问题。
签名 URL 仅限制首次渲染；缓存的图片持续有效，因此已分享的卡片仍可正常使用。
修改标题 → 修改 URL → 触发一次新的渲染。当您强制重新抓取时，平台（最终）会获取新的卡片。

常见问题解答

FastOG 能保证我的 og:image 一定显示吗？

FastOG 会从公开 URL 生成一张有效的 1200×630 PNG 图片。平台是否显示它取决于其缓存机制——更换图片后，请使用验证工具重新抓取。

为什么我更新图片后，Facebook 仍然显示旧图？

Facebook 会缓存抓取结果，并且会保留自己保存的图片副本——因此仅更换新的 og:image URL 并不会让它更新。请使用 Sharing Debugger → 点击“Scrape Again”（重新抓取）；强制刷新 Facebook Open Graph 缓存一文介绍了 API 调用方式、所需的应用令牌以及需要遵守的速率限制。

如何强制 X 显示我的新卡片？

打开 X Card Validator（卡片验证工具），粘贴 URL。它会重新抓取最新的 og:image 和 twitter:image。