頁面上線了、連結也分享出去了——結果預覽顯示錯誤的圖片，甚至什麼都沒有。幾乎所有 OG image 問題都不出這三種：**標籤缺失、圖片 URL 失效、快取過舊。**本指南會示範如何在分享前預覽 OG image，並在每種狀況發生時逐一修復。
先檢查標籤
在動用任何工具之前，先檢視頁面原始碼（Ctrl+U / Cmd+U），確認 <head> 裡有這些標籤：
<meta property="og:title" content="Launch day: v2.0" />
<meta property="og:description" content="Everything new in this release." />
<meta property="og:image" content="https://example.com/og/launch.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />兩條規則就能立刻抓出大多數問題：
og:image必須是絕對 HTTPS URL。相對路徑（/og/launch.png）在大多數爬蟲上都會失敗。- 圖片 URL 必須公開可存取——用無痕視窗打開它。如果需要登入、發生重新導向或回傳 404，任何平台都抓不到。
如果你不確定圖片尺寸是否正確，先讀我們的 OG image 尺寸指南——正確的尺寸是預覽成功的另一半。
各平台的預覽工具
各大平台都提供官方除錯工具，能完整呈現其爬蟲實際看到的內容：
| 平台 | 工具 | 功能 |
|---|---|---|
| Sharing Debugger（分享除錯工具） | 顯示抓取到的卡片、列出警告，並提供「Scrape Again」（重新抓取）按鈕 | |
| Post Inspector（貼文檢查器） | 渲染預覽，且每次檢查都會更新 LinkedIn 的快取 | |
| X (Twitter) | 建立一則草稿貼文 | X 已停用獨立的 Card Validator 預覽——把連結貼進草稿（或私訊給自己）就能看到實際卡片 |
| Slack | 傳訊息給自己 | Slack 會即時展開連結；傳私訊給自己是最快的 OG 預覽方式 |
| Discord | 貼到任一頻道 | 嵌入卡片會依你的 Open Graph 標籤立即顯示 |
| WhatsApp / Telegram | 傳到「Saved messages」/自己 | 兩者都讀取 og:image；Telegram 快取很頑強（見下文） |
一套實用流程：先修好標籤 → 跑一次 Facebook Sharing Debugger（它的警告最詳細）→ 再抽查你真正在意的平台。
強制更新快取
平台會非常積極地快取連結預覽——有時長達數週。如果你已經更新了 OG 圖片，卻一直看到舊的：
- Facebook： 打開 Sharing Debugger，點擊 Scrape Again。
- LinkedIn： 把 URL 丟進 Post Inspector——檢查這個動作本身就會清掉快取。
- X： 沒有手動更新機制；快取通常一週左右會自行過期。
- Telegram： 把你的 URL 傳給
@WebpageBot，強制重新爬取。 - 萬用備案： 換掉圖片 URL。加上版本參數（
/og/launch.png?v=2）——或者更好的做法：使用內容雜湊檔名——所有平台都會立刻把它當成一張全新的圖片。
如果你的 OG 圖片是由自動化流程產生的，從第一天就把版本號或雜湊值放進檔名。快取失效從此不再是問題。
為什麼 OG 圖片還是不顯示
除錯工具都跑過了，圖片還是沒出現？照這份清單逐項排查：
- 圖片太大或載入太慢。 好幾 MB 的檔案會讓爬蟲逾時。控制在 1 MB 以內（WhatsApp 要遠低於 300 KB）。
- 圖片尺寸低於大卡片門檻。 小於 600×315 時，Facebook 會退回小縮圖。請以 1200×630 輸出——尺寸指南有完整說明。
- 頁面擋掉了爬蟲。 檢查
robots.txt、防火牆或機器人防護層是否對facebookexternalhit、Twitterbot或LinkedInBot回傳 403。 - 標籤是由用戶端注入的。 大多數社群爬蟲不會執行 JavaScript。OG 標籤必須存在於伺服器渲染的 HTML 中。
- 多個
og:image標籤互相衝突。 平台通常只取第一個——把範本或外掛留下的多餘標籤清掉。
在發佈前預覽，而不是發佈後
上面的除錯工具只能在事後告訴你哪裡出錯。更省力的習慣，是讓圖片在上線前就是對的。我們的免費 OG image 產生器會在你編輯時以精確的 1200×630 尺寸即時預覽——編輯器裡看到的畫面，和最終卡片逐像素一致——並輸出能通過本文所有檢查的最佳化 PNG。免註冊、無浮水印。
常見問題
如何在不發文的情況下預覽 OG image？
想看官方渲染結果，用 Facebook Sharing Debugger 或 LinkedIn Post Inspector；或者在 Slack、Discord 或 WhatsApp 把連結傳給自己——傳給自己的訊息，展開效果和公開分享一模一樣。
OG image 的快取會留多久？
各平台不同：Facebook 會一直快取，直到你強制重新抓取；LinkedIn 透過 Post Inspector 更新；X 大約一週後自行過期。換掉圖片 URL（?v=2 或新檔名）可以一次繞過所有平台的快取。
為什麼 OG 圖片在 Facebook 顯示正常，WhatsApp 卻看不到？
幾乎都是檔案大小的問題。WhatsApp 遇到太重的圖片會直接放棄——壓縮你的 PNG 或改用較小的版本，並保持遠低於 300 KB。
用 JavaScript 渲染的頁面，OG 標籤有效嗎？
只有當標籤出現在伺服器的初始回應中才有效。社群爬蟲基本上不執行 JavaScript，用戶端注入的 meta 標籤對它們來說完全看不見。
