关于LinkedIn Sharing API分享无法显示大图的技术咨询

我之前也碰到过类似的LinkedIn分享图片不显示的问题，结合你的情况和LinkedIn API的规则，来给你梳理下可能的原因和解决办法：

先把你的请求示例贴出来方便参考：

{ 
  "comment": "How Triggre achieves its simplicity", 
  "content": { 
    "title": "Triggre / Blog / Design Philosophy - Part 3", 
    "description": "In the previous two posts about our design philosophy you could read how we decided to build Triggre and why we chose simplicity as the core of our desi...", 
    "submitted-url": "https://www.triggre.com/en/blog/the-triggre-design-philosophy-part-3/", 
    "submitted-image-url": "https://www.triggre.com/media/1105/sagrada-familia.jpg?width=800" 
  }, 
  "visibility": { "code": "anyone" } 
}

可能的原因分析 #

• LinkedIn爬虫无法访问图片资源
  LinkedIn的分享系统会主动抓取你提供的图片URL，如果你的服务器、CDN或者防火墙设置了反爬规则，限制了LinkedInBot（LinkedIn的爬虫用户代理）的访问，就会导致图片无法被抓取显示。你可以去服务器的访问日志里查一查，看看有没有LinkedIn爬虫的访问记录，是否返回了4xx或5xx的错误码。

• 图片规格不符合LinkedIn要求
  LinkedIn对分享大图有明确的规格限制：建议尺寸是1200x628像素，最小不能低于600x315像素；格式支持JPG、PNG、静态GIF；文件大小不能超过5MB。你的图片URL里指定了宽度800，但如果高度不足315的话，就不符合最小要求，会被降级显示小图或者不显示。

• 页面OG标签与API参数冲突
  虽然你在API请求里指定了submitted-image-url，但LinkedIn会优先抓取submitted-url目标页面里的OG元标签（比如og:image）。如果页面里的og:image指向的是另一张图，或者OG标签设置不完整（缺少og:image:width/og:image:height），API里的图片参数可能会被忽略。

• 动态图片URL的潜在问题
  你的图片URL带有?width=800的参数，属于动态生成的资源。有些情况下，这类动态URL可能会存在缓存失效、权限验证或者CDN节点同步延迟的问题，导致LinkedIn爬虫抓取不到正确的图片资源。

可行的解决方案 #

• 允许LinkedIn爬虫访问资源
  在你的服务器robots.txt文件里添加允许规则，确保LinkedInBot能正常访问图片目录：

  User-agent: LinkedInBot
  Allow: /media/
  

  同时检查CDN或防火墙的规则，解除对LinkedInBot的访问限制。

• 调整图片规格
  将图片调整到符合LinkedIn建议的1200x628像素尺寸，保存为JPG或PNG格式，确保文件大小在5MB以内。之后更新API请求里的submitted-image-url为调整后的图片地址。

• 优化页面OG元标签
  在你的博客页面头部添加完整的OG图片标签，比如：

  <meta property="og:image" content="https://www.triggre.com/media/1105/sagrada-familia.jpg?width=1200" />
  <meta property="og:image:width" content="1200" />
  <meta property="og:image:height" content="628" />
  

  这样即使API参数出现问题，LinkedIn爬虫也能从页面元数据里抓取到正确的大图资源。

• 使用LinkedIn官方工具排查
  用LinkedIn官方的帖子检测工具输入你的submitted-url，查看爬虫抓取的结果，确认图片是否被正确识别。如果工具里显示图片正常，那可能是LinkedIn的缓存问题，可以等待1-2小时再测试，或者通过工具手动刷新缓存。

• 测试静态图片URL
  尝试去掉图片URL里的?width=800参数，直接使用原始图片的URL发起API请求，看看是否能正常显示大图。动态参数有时候会干扰爬虫的抓取逻辑。

我当时是因为服务器防火墙误屏蔽了LinkedInBot，调整规则后问题就解决了。你可以按照上面的步骤逐一排查，应该能找到问题所在。

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