og:image 未顯示？如何修復

og:image 未顯示幾乎總是歸因於以下五種原因之一：圖片 URL 未公開、圖片過大、平台快取了舊版本、標籤指向了錯誤的頁面，或圖片格式不受支援。本指南將逐步說明每個修復方法，並使用 Facebook、X 和 LinkedIn 提供的除錯工具。

為什麼我的 og:image 沒有顯示？

最常見的原因是圖片 URL 無法公開抓取、檔案超過平台限制，或是平台顯示的是快取副本。社群平台會依排程重新抓取並積極快取，因此新圖片通常看起來「沒有生效」，直到您使用它們的偵錯工具強制重新整理為止。

最常見的五個原因（及修正方式）

1. 圖片網址未公開

平台必須在無需驗證的情況下取得圖片。位於登入頁面、localhost 或 IP 位址後方的網址都會失敗。

修正方式： 將圖片放在公開的 HTTPS 網址，並確認 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 也會自行儲存一份圖片副本，並以頁面網址作為預覽的鍵值，因此僅更換圖片網址並不會更新預覽。變更圖片後，舊卡片仍會持續顯示數小時或數天。

修正方式： 使用平台的工具強制重新抓取（見下方）。若要變更圖片，請使用會隨內容變化的網址（FastOG 的簽署網址會自動處理）。至於唯一允許程式化重新整理的平台，請參閱強制重新整理 Facebook Open Graph 快取。

4. 網址錯誤或頁面錯誤

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。