dootask/resources/ai-kb/zh/faq/common-faq/upload-image-error.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
common-faq.upload-image-error.faq	图片预览失败	faq	common-faq	end-user	zh	图片传上去打不开 图片裂了 缩略图加载不出 显示损坏图标 图片 404 图片预览失败		file_detail dialog_image_viewer		图片上传成功不代表预览一定成功——缩略图是异步生成的，可能慢几秒 HEIC / HEIF / TIFF / RAW / PSD 等格式默认不生成缩略图 浏览器层缓存被污染后即使服务端图片正常也可能裂；得清缓存	v1.7.90

图片预览失败

问题

图片成功上传，但消息气泡 / 文件详情显示破图、灰底叹号、加载圈一直转，或点开提示「图片加载失败」。

原因

• 缩略图未生成：服务端 GD/Imagick 在后台异步生成缩略图，前 1-3 秒内显示原图占位
• 格式不被识别：HEIC、TIFF、PSD、RAW 等格式 GD 默认无法解码
• GIF 自动转静图：GIF 上传时若 autoThumb 关闭，则保留原文件不做缩略图
• 图片实际损坏：截图工具偶尔输出未关闭的字节流；上传成功但服务端解码失败
• Token 过期：图片 URL 带签名 / cookie，长时间停留页面后凭证失效返回 401/403
• CDN / 反代缓存了坏图：之前传过损坏图，CDN 把坏字节缓存下来

解决

1. 先等 3 秒刷新页面看是否是缩略图未及时生成
2. 改 PNG/JPG/WEBP 重新上传（不要传 HEIC）
3. 刷新页面（Ctrl/Cmd + Shift + R 强刷绕过缓存）后重试
4. 重新登录或重新打开标签让 token 续期
5. 链接拷出来直接在浏览器打开，能下载但不能渲染 → 图片本身坏；能下能渲染 → 前端缓存问题
6. 服务端管理员：检查 public/uploads/ 目录权限、磁盘剩余空间、docker logs dootask-php 看是否报 GD 错误

不支持

• 用户端没有「重建缩略图」按钮，重传一次即可触发
• 富文本 / 聊天里的过期签名链接不会自动续签，需重新打开整个消息

通用上传卡顿见 common-faq.upload-stuck.faq