X (Twitter) 卡片未显示或未更新
X 会优先根据 twitter: 标签生成卡片预览,如果不存在则会回退使用 og: 标签。现在已经不再提供可以刷新缓存的验证工具了,因此解决方法就是配置正确的标签,并使用一个全新的 URL。
最后更新
快速修复
使用 Twitter 卡片验证器检查页面。
将 twitter:card 设置为 summary_large_image 并添加 twitter:image 或 og:image。
使用 5 MB 以下且格式为 JPG、PNG、WebP 或 GIF 的 2:1 比例图片。
分享带有 ?v=2 的 URL,以便 X 将其作为新链接抓取。
为什么 X 卡片缺失或未更新
没有
twitter:card标签,或者它被设置为了非预期的类型。robots.txt 或防火墙拦截了
Twitterbot。X 的故障排除指南将两者均列为常见原因。图片违反了规则。不支持 SVG 格式,且文件必须小于 5 MB。
X 缓存了旧卡片。其指南指出,抓取工具大约每 7 天重新索引一次卡片标签。
图片 URL 没有改变。缓存以图片地址为键,因此新图片需要新的 URL。
如何修复
在 Twitter 卡片验证器中运行该 URL,查看 X 将生成的卡片。
添加
<meta name="twitter:card" content="summary_large_image">。将
twitter:image或og:image指向页面专用的独特图片,而不是您的徽标(Logo)。在 robots.txt 以及 CDN 或防火墙规则中允许 Twitterbot。
分享带有查询字符串(如
?v=2)的链接,以获取全新抓取。
X 读取的标签
twitter:card:summary_large_image或summarytwitter:title,备用回退至og:titletwitter:description,备用回退至og:descriptiontwitter:image,备用回退至og:imagetwitter: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: 版本。