Ruby on Rails项目WebP格式图片链接无法在聊天平台预览如何解决

根本原因：当前Slack、Skype、StackOverflow等平台的链接预览爬虫尚未完全兼容WebP格式，仅默认识别JPG、PNG等传统图片格式的MIME类型与文件后缀，因此爬取WebP资源时会判定为非可预览图片。

适配方案（Ruby on Rails 场景） #

• 多格式兼容+内容协商策略 #

  同时保留WebP和原JPG/PNG两份图片资源，根据请求类型返回对应格式：

  • 普通用户访问页面时，前端优先加载WebP格式图片，减少带宽消耗
  • 检测到请求来自平台爬虫时，页面OG标签（og:image）返回JPG格式资源地址，匹配爬虫的识别规则
  • 若为图片直链访问，可根据请求头Accept是否包含image/webp返回对应格式，保持URL不变的前提下兼容两端需求

• 中间件路由重定向 #

  新增Rails中间件对爬虫请求做特殊处理，匹配到社交平台爬虫UA时自动将WebP请求重定向到同路径的JPG资源，示例代码：

  # app/middleware/webp_crawler_fallback.rb
  class WebpCrawlerFallback
    # 可根据需求扩展需要适配的爬虫UA标识
    CRAWLER_UA_RULE = /Slackbot|SkypeUriPreview|StackOverflow|Twitterbot|FacebookExternalHit/i
  
    def initialize(app)
      @app = app
    end
  
    def call(env)
      request = Rack::Request.new(env)
      # 匹配WebP请求+爬虫UA的场景
      if request.path.end_with?('.webp') && env['HTTP_USER_AGENT']&.match?(CRAWLER_UA_RULE)
        jpg_path = request.path.sub(/\.webp$/, '.jpg')
        # 验证JPG资源存在后返回302重定向
        if File.exist?(File.join(Rails.public_path, jpg_path.delete_prefix('/')))
          return [302, { 'Location' => jpg_path, 'Content-Type' => 'text/plain' }, []]
        end
      end
      @app.call(env)
    end
  end
  

  在config/application.rb中注册中间件即可生效。

• CDN自适应转码 #

  若项目使用CDN托管静态资源，可直接开启CDN的自适应图片格式转换功能，配置规则为爬虫请求时默认返回JPG格式，普通用户请求优先返回WebP，无需修改业务代码即可实现兼容。

• 实时转码回退 #

  若不想存储多份图片资源，可使用image_processing等Ruby图片处理库，对爬虫请求的WebP资源实时转码为JPG返回，搭配缓存机制避免重复转码消耗性能。

注意事项 #

配置OG标签时，若返回JPG格式的预览图，需同步将og:image:type属性设置为image/jpeg，避免部分平台识别异常。

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