dootask/resources/ai-kb/zh/faq/common-faq/upload-stuck.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-stuck.faq	上传卡住进度不动	faq	common-faq	end-user	zh	上传卡住 进度条不动 一直转圈 上传超时 上传中断 99% 卡死		file_upload		没有「断点续传」按钮，卡住后只能重新上传整个文件 服务端任务排队不可视化（同一用户同目录并发会排队，看着像卡住但其实在等） 关浏览器标签会立刻中断当前上传	v1.7.90

上传卡住进度不动

问题

拖了文件后进度条停在某个百分比不动，或者一直「上传中…」、转圈，最终超时或自动失败。

原因

DooTask 上传卡顿常见于：

1. 网络抖动 / VPN：上行带宽不稳，TCP 重传拖累整个请求
2. 同一用户同目录并发：后端用 atomic lock 排队避免数据库死锁，前一个文件没传完后一个等着
3. 反向代理超时：Nginx 的 proxy_read_timeout、client_body_timeout 默认值偏小，超大文件传到尾段断开
4. 磁盘满 / inode 用尽：服务端写不进文件
5. PHP 进程超 max_execution_time：CLI / FPM 限制了脚本执行时间

解决

1. 先刷新页面、关掉 VPN，换稳定网络重试小文件验证链路
2. 多文件同目录上传 → 改为分目录或串行（一次传一个），避免锁排队
3. 上传到 99% 失败大多是反向代理超时 → 让管理员调大 nginx 的 proxy_read_timeout 600s、client_body_timeout 600s
4. 服务端 df -h 查容量；df -i 查 inode；满了清 public/uploads/tmp 缓存
5. 改 docker/php/php.ini 的 max_execution_time 和 max_input_time 后重启 PHP 容器

不支持

• 客户端不做断点续传，卡断后必须重头传
• 浏览器关闭即上传中断，不会保留到后台继续

如果是聊天发文件卡住：先关掉所有 dootask 标签再重开，会清空前端待发队列。