Twitter Card 影像不顯示：7 個原因和修復方法

您的帶有連結的推文不會顯示任何圖像 - 只是一個簡單的 URL。以下是 7 個最常見的原因以及解決每個原因的具體方法。

Twitter Card 圖片遺失的 7 個原因

當 X（以前稱為 Twitter）上共享的 URL 不顯示卡片圖像時，幾乎總是這七個問題之一。讓我們逐一討論。

1. twitter:card標籤遺失或不正確

X 需要明確 twitter:card 標籤。沒有它，X 根本不會渲染卡片——即使你的 OG 標籤是完美的。

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Your Title" />
<meta name="twitter:description" content="Your description" />
<meta name="twitter:image" content="https://yoursite.com/image.jpg" />

有兩種卡片類型：summary（小縮圖）和summary_large_image（完整卡片）。使用summary_large_image以獲得最佳視覺效果。

2. 圖片太小

X 的最小影像尺寸要求：

• summary_large_image:最小800×418像素
• 摘要：最小400×150像素
• 推薦： 1200×628（適用於所有平台）

如果您的圖像小於最小值，X 會默默地丟棄卡片。沒有錯誤訊息 - 連結僅顯示為純文字。

3. 圖片 URL 不可公開訪問

X 的爬蟲必須能夠在無需身份驗證的情況下獲取您的圖像。常見的攔截器：

• 登入牆或身份驗證後面的圖片
• 被robots.txt阻止
• Cloudflare或CDN向爬蟲返回403/429錯誤
• CORS 限制阻止跨源獲取

4. Twitter 的快取尚未刷新

與所有平台一樣，X 快取卡資料。更新標籤後，X 不會拾取更改，直到快取過期或您強制刷新。

<meta property="og:image" content="https://yoursite.com/new-image.jpg" />

使用 Twitter Card Validator 輸入您的 URL 並觸發快取刷新。驗證器準確地向您顯示 X 所看到的內容。

5. MIME 類型錯誤或影像損壞

如果您的圖像伺服器傳回錯誤的 MIME 類型（例如，使用 image/jpeg 內容類型提供 PNG），X 可能會拒絕它。同樣，損壞或部分載入的影像將被刪除。

6. 頁面向 Twitter 爬蟲回傳錯誤

如果 Twitter 機器人在取得您的頁面時返回 4xx 或 5xx 錯誤，則不會產生任何卡片。這可能發生在：

• 需要 JavaScript 渲染的 SPA 應用程式（Twitter 的爬蟲不執行 JS）
• 阻止美國爬蟲的地理封鎖
• Cloudflare 十字轉門或驗證碼

7. 僅使用 OG 標籤而不使用 Twitter Card 標籤

雖然X 可以回落到OG標籤，但它更喜歡twitter:card標籤。如果您只設定 og:image 而沒有設定 twitter:image，X 可能無法正確渲染卡片。始終設定兩者。

<!-- Open Graph (for LinkedIn, Discord, Slack, WhatsApp) -->
<meta property="og:image" content="https://yoursite.com/image.jpg" />

<!-- Twitter/X specific (for X/Twitter) -->
<meta name="twitter:image" content="https://yoursite.com/image.jpg" />

快速修復清單

常見問題解答