X (Twitter) 卡片未显示或未更新

X 会优先根据 twitter: 标签生成卡片预览,如果不存在则会回退使用 og: 标签。现在已经不再提供可以刷新缓存的验证工具了,因此解决方法就是配置正确的标签,并使用一个全新的 URL。

最后更新

快速修复


  1. 使用 Twitter 卡片验证器检查页面。

  2. 将 twitter:card 设置为 summary_large_image 并添加 twitter:image 或 og:image。

  3. 使用 5 MB 以下且格式为 JPG、PNG、WebP 或 GIF 的 2:1 比例图片。

  4. 分享带有 ?v=2 的 URL,以便 X 将其作为新链接抓取。


为什么 X 卡片缺失或未更新

  • 没有 twitter:card 标签,或者它被设置为了非预期的类型。

  • robots.txt 或防火墙拦截了 Twitterbot。X 的故障排除指南将两者均列为常见原因。

  • 图片违反了规则。不支持 SVG 格式,且文件必须小于 5 MB。

  • X 缓存了旧卡片。其指南指出,抓取工具大约每 7 天重新索引一次卡片标签。

  • 图片 URL 没有改变。缓存以图片地址为键,因此新图片需要新的 URL。

如何修复

  1. 在 Twitter 卡片验证器中运行该 URL,查看 X 将生成的卡片。

  2. 添加 <meta name="twitter:card" content="summary_large_image">。

  3. 将 twitter:image 或 og:image 指向页面专用的独特图片,而不是您的徽标(Logo)。

  4. 在 robots.txt 以及 CDN 或防火墙规则中允许 Twitterbot。

  5. 分享带有查询字符串(如 ?v=2)的链接,以获取全新抓取。

X 读取的标签

  • twitter:card:summary_large_image 或 summary

  • twitter:title,备用回退至 og:title

  • twitter:description,备用回退至 og:description

  • twitter:image,备用回退至 og:image

  • twitter:image:alt,最多 420 个字符

  • twitter:site 对应 @用户名

图片尺寸规则

  • summary_large_image 的宽高比为 2:1

  • 最小 300 x 157 像素,最大 4096 x 4096 像素

  • 小于 5 MB

  • JPG、PNG、WebP 或 GIF(仅第一帧);不支持 SVG

如何强制刷新

X 没有刷新工具。卡片验证器已在 2022 年移除了预览功能。分享带有新查询字符串的 URL,或者在替换图片时更改图片 URL。已经发布的帖子将保留其现有卡片。刷新工具提供了适用于每个应用程序的步骤。

未经核实:X 已从 developer.x.com 移除了其卡片文档。本页面上的规则来自 X 文档的 2024 年归档版本,可能已发生变化。

来源

常见问题

Twitter 的 summary_large_image 卡片适合使用多大尺寸的图片?

宽高比为 2:1 的图片,尺寸介于 300 x 157 像素和 4096 x 4096 像素之间,大小不超过 5 MB,格式支持 JPG、PNG、WebP 或 GIF。

如何刷新 Twitter 卡片?

现在已经没有官方的刷新按钮了。分享带有新查询字符串的 URL,这样 X 就会重新抓取它。

X 会使用 Open Graph 标签吗?

是的,作为备用方案。如果缺少 twitter:title、twitter:description 或 twitter:image,X 会使用对应的 og: 版本。

检查您的页面,然后刷新预览

将您的网址粘贴到免费检查器中,查看各个应用程序读取的具体标签。标签确认无误后,使用刷新工具清除旧的预览。