把 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 行为更激进。
- 刷新会丢对话吗? 不会,刷新安全。对话存在服务端,只是页面内状态重新加载。