Telegram Bot内联搜索自定义GIF URL无法正常工作求助

问题描述 #

使用InlineQueryResultGif API时，传入自有服务器托管的GIF URL，内联搜索栏显示“无结果”，资源无法正常加载；但传入Giphy等第三方平台的GIF URL时，功能完全正常。

示例代码：

InlineQueryResultGif(
    id = str(uuid4()),
    title = "giff",                                                 
    gif_url = "https://media0.giphy.com/media/kA5Gnnr2bcEIzu26DT/giphy.gif",
    thumbnail_url = "https://media0.giphy.com/media/kA5Gnnr2bcEIzu26DT/giphy.gif"
)

可能原因 #

• 服务器访问限制：自有服务器的防盗链、CORS策略或防火墙拦截了Telegram服务器的资源请求，而Giphy等平台默认允许外部抓取。
• GIF格式/大小不达标：Telegram要求GIF必须是标准格式（不能是MP4伪装），且文件大小通常限制在5MB以内，自有服务器的GIF可能不符合要求。
• HTTPS证书不被信任：自有服务器使用自签名或过期证书，Telegram验证失败拒绝请求；第三方平台用的是权威CA证书，能通过验证。
• URL公网不可达：自有服务器的GIF URL在公网无法直接访问，存在路径错误、重定向或权限限制，导致Telegram无法获取资源。

解决办法 #

• 调整服务器策略：
  • 关闭防盗链限制，或添加Telegram服务器IP段到白名单。
  • 配置CORS规则，允许Telegram域名跨域请求资源。
• 规范GIF文件：
  • 用工具（如GIMP、在线GIF压缩器）将文件导出为标准GIF格式，避免用视频文件重命名。
  • 压缩GIF大小至5MB以内，可通过减少帧数量或降低分辨率实现。
• 更换HTTPS证书：
  • 部署权威CA颁发的免费证书（如Let's Encrypt），确保证书有效、未过期且配置正确。
• 验证URL有效性：
  • 在公网环境下直接访问GIF URL，确认能正常打开无报错。
  • 检查URL路径是否正确，避免特殊字符或编码问题。

内容的提问来源于stack exchange，提问作者Alireza Kavian