Claude 附件预览不显示:只有 tile 没有缩略图

上传 PDF 或图片,Claude 显示文件 tile 但没缩略图。多半是 CDN 时序、MIME 错配、或浏览器缓存——逐项修复。

把 PDF 或 PNG 拖进聊天框。附件 tile 出来了,文件名、大小都有,但缩略图是一片灰、一个图片损坏图标、或者干脆什么都没有。更糟的是从 UI 上你也看不出来 Claude 到底是真收到内容还是只收到了元数据。多数情况下文件其实上传成功了、Claude 也能读,只是预览层挂了。常见原因有几种:CDN 时序问题,缩略图生成落后于上传;MIME 类型奇怪,预览管线不认;浏览器缓存脏;或者图片格式 Claude 看得懂、但预览器光栅化不出来。

常见原因

按命中率从高到低。

1. 缩略图生成落后于文件上传

文件已经上传、索引完,但缩略图是另一个服务生成的,偶尔会延迟几秒。

怎么判断:等 30 秒刷新页面,缩略图出来了,那就是这个原因。

2. 客户端和服务端 MIME 类型不一致

有些浏览器对不常见文件类型直接打成 application/octet-stream。预览器没法猜该怎么 render,只好退回到空 tile。

怎么判断:在系统里右键文件看真实类型。如果跟上传对话框显示的不一样,多半就是 MIME 混乱。

3. 浏览器缓存留着旧的 render 结果

正常很少 hard refresh,预览 CDN 缓存头又很长。一次失败的 render 在这个 session 里可能一直被缓存返回。

怎么判断:在无痕窗口里试。预览出来了,那就是常用浏览器缓存脏了。

4. PDF 或图片超出预览管线处理能力

100 页以上 PDF、2000 万像素以上图片,经常会跳过缩略图生成节省算力。但 Claude 自己还是能读。

怎么判断:看文件大小和尺寸。任意一个偏大都对得上。

5. 不支持的图片格式(HEIC、AVIF、TIFF)

Claude 能读新格式,但预览器基本只处理 PNG、JPG、GIF、WebP。其他格式能传上去但没缩略图。

怎么判断:看文件扩展名。HEIC、TIFF、AVIF、BMP 的预览支持都比较参差。

6. 网络把缩略图 CDN 挡了

企业代理和某些广告拦截会拦三方 CDN 域名。文件上传走主 API 端点没事,但缩略图 CDN 走不通。

怎么判断:打开 DevTools → Network,过滤 image,找被 block 或者 4xx 的 CDN 子域名请求。

开始前

  • 先确认 Claude 确实读到了内容——问一个关于文件的简单问题(「第一页标题是什么?」),答得对就说明文件进去了。
  • 想清楚预览对你的工作流到底有多重要,没有预览能不能继续。
  • 准备一个备用浏览器(Safari 用户备 Chrome,反之亦然)。

需要收集的信息

  • 文件类型、大小、尺寸或页数。
  • 浏览器、版本、OS、当前启用的扩展。
  • tile 显示的是文件图标还是图片损坏图标。
  • 网络环境:公司 VPN、公共 Wi-Fi、家庭宽带。
  • 附件 tile 截图,加上 DevTools 控制台报错。
  • 同一对话里别的附件能不能正常显示。

一步一步修复

Step 1:等一下、刷新

给它 30 秒再刷新对话。多数失败的预览第二次加载就恢复了,因为 CDN 这时候赶上了。

Step 2:确认 Claude 真的拿到内容

让它:「不要重新读,用两句话总结我刚上传的文件。」总结对得上就说明上传成功、只是预览坏,可以继续干活。

Step 3:换个干净格式重新上传

HEIC 转 JPG,AVIF 转 PNG,TIFF 转 JPG。50 MB 以上 PDF 用 Adobe Acrobat 或 Smallpdf 压一下。换更干净的版本重传,缩略图通常就出来了。

Step 4:无痕窗口里重传

在无痕窗口或 Guest 窗口里打开同一对话(不会加载扩展),重传文件。这里预览能出来,那就说明常用浏览器缓存脏了或者有挡 CDN 的扩展。

Step 5:扩展一个一个关

主浏览器里把扩展全关掉刷新。uBlock、Privacy Badger、企业安全扩展是最常见的捣乱者。一个一个开回来,直到预览又挂了为止。

Step 6:换个网络试

用手机开热点连一下。蜂窝网下预览能出来,那就是公司或家里的网在挡 CDN。提个工单让 IT 把 Anthropic 预览域名加白。

Step 7:长期失败的关键文件走 API

那种必须有预览的关键文件,改用 Files API 而不是 web UI。API 返回一个 file_id 直接引用,跳过预览层。

怎么验证修好了

  • 上传 10 秒内 attachment tile 里出现缩略图。
  • 点缩略图能打开全尺寸预览。
  • Claude 关于文件内容的回答是对的。
  • 一分钟后再刷一次对话,缩略图还在。

长期预防

  • 上传前把 HEIC、AVIF 转成 JPG 或 PNG,iOS 文件 App 和 macOS 预览 App 都能转。
  • PDF 上传前压到 50 MB 以下,或者拆开。
  • 公司代理和广告拦截里把 Anthropic CDN 域名加白名单。
  • 留一个不装扩展的浏览器 profile 专门做上传密集型的活。
  • 自动化 pipeline 用 Files API 而不是 web UI。

容易踩的坑

  • 看到没缩略图就以为 Claude 没读到文件。先问个问题确认再重传。
  • 同一个坏文件重传 5 次,MIME 没变结果也不会变——换格式。
  • 觉得 iPhone 照片分享出来就是 JPG。其实经常是 HEIC,看扩展名。
  • 忘了 Safari 拖放有时会丢原始 MIME,改用 Upload 按钮。
  • 看到第一页有预览就觉得后面全可读。有时候只有第一页被索引了。

常见问答

  • 没有缩略图 Claude 真的收到文件了吗? 多数情况下是的。让模型总结一下就能确认。
  • 哪些格式预览稳定? PDF、PNG、JPG、GIF、WebP、纯文本、CSV、Markdown。Office 系列是文本抽取式预览、不是视觉预览。
  • HEIC 为啥失败? 预览管线在很多环境下不光栅化 HEIC。上传前转 JPG。
  • 大小有上限吗? Web UI 软上限 32 MB/文件,Files API 支持 500 MB。
  • 手机上预览比桌面好吗? 反而稍差。Mobile Safari 对缓存和 CDN 行为更激进。
  • 刷新会丢对话吗? 不会,刷新安全。对话存在服务端,只是页面内状态重新加载。

相关

标签: #Claude #排查 #PDF #排查