网站首页Telegram中Open Graph预览不显示问题咨询
Telegram不显示首页Open Graph预览的排查与解决方法
可能的原因
- Telegram缓存残留:首页作为高频访问页面,Telegram爬虫可能缓存了早期无OG标签的版本,即使你现在更新了标签,缓存未自动刷新。
- 客户端渲染导致标签不可抓取:如果首页依赖JavaScript动态插入OG标签,Telegram爬虫不会执行JS,自然抓不到标签;而其他页面是服务器端渲染,标签直接存在于源码中。
- 服务器响应异常:首页可能返回了4xx/5xx错误状态码给Telegram爬虫,或者响应超时,导致爬虫放弃抓取;其他页面响应正常。
- OG标签细节问题:看似一致的标签可能存在细微错误,比如
og:image用了相对路径、图片尺寸不符合要求(过小或比例不对)、标签拼写错误(如og:img代替og:image),或是og:url与实际URL不匹配。 - 反爬/UA限制:服务器或CDN可能对Telegram爬虫的用户代理(UA)做了限制,返回无标签的内容;其他页面未触发该限制。
解决步骤
- 强制刷新Telegram缓存:发送消息给
@WebPageBot,附上首页链接,让Bot重新抓取并更新缓存;也可以在首页URL后添加随机参数(如?refresh=1),强制Telegram重新请求页面。 - 确认OG标签的渲染方式:右键查看首页源代码,搜索
og:开头的标签,确认它们直接存在于HTML头部,而非通过JS动态生成。如果是客户端渲染,需要改为服务器端渲染输出OG标签。 - 模拟爬虫请求验证响应:用curl命令模拟Telegram爬虫的UA请求首页,检查返回的状态码和内容是否包含OG标签:
确保返回200状态码,且HTML头部存在完整的OG标签。curl -A "Mozilla/5.0 (compatible; TelegramBot/1.0; +https://core.telegram.org/bots/webhooks)" https://andrei-psyhelp.ru/ - 校验OG标签细节:
- 确保
og:image是绝对URL,且可直接访问(无防盗链拦截)。 - 图片尺寸建议至少600x315像素(符合Telegram的1.91:1比例要求),格式优先用JPG或PNG。
- 核对所有OG标签的拼写,比如
og:title、og:description、og:url是否准确,og:url需与页面实际URL完全一致(包括HTTPS和域名)。
- 确保
- 检查反爬配置:查看服务器防火墙、CDN规则或安全插件,确认未对Telegram爬虫的UA进行拦截,允许其正常访问首页。
- 用验证工具排查问题:使用OG标签验证工具检查首页,查看是否有标签错误或抓取异常的提示,辅助定位问题。
内容的提问来源于stack exchange,提问作者voldr
相关产品推荐
相关产品推荐

