uni.uploadfile 不支持断点续传，必须用 uni.request 手动实现分片上传，配合服务端校验、客户端状态持久化与 md5 校验。
uni-app 里用 uni.uploadFile 做断点续传行不通
直接说结论：uni.uploadFile 是个黑盒封装，不暴露底层 XMLHttpRequest 或 Fetch 的上传进度、暂停、恢复能力，也没提供分片控制权。想靠它原生支持断点续传，不可能。
真正可行的路只有一条：自己用 uni.request（或 H5 环境下用原生 fetch/XMLHttpRequest）手动实现分片上传 + 断点记录。小程序端受限于 API，必须依赖服务端配合校验已上传分片。
- 小程序平台（微信/支付宝）不支持读取文件局部字节，必须先用
uni.getFileSystemManager().readFile或uni.downloadFile后再切片，但大文件容易内存溢出 - H5 环境可用
File.slice()安全分片，推荐优先在 H5 调试逻辑 - App 端（iOS/Android）可通过
uni.getFileSystemManager()读取本地路径，但要注意权限和路径格式（如_www/或documents/）
服务端必须支持分片上传校验接口
客户端能“断”能“续”，前提是服务端知道“传到哪了”。不能只靠文件名判断——同名文件可能来自不同用户、不同时间、不同分片策略。
标准做法是让客户端上传前先请求一个 /api/upload/init 接口，传入：fileMd5（整个文件的 MD5）、fileName、fileSize。服务端返回：uploadId（本次上传唯一 ID）、uploadedChunks（已成功接收的分片序号列表，如 [0,1,3]）。
- 分片大小建议固定为
5 * 1024 * 1024（5MB），太小增加 HTTP 开销，太大不利于失败重试 - 每个分片请求需带参数：
uploadId、chunkIndex、totalChunks、chunkMd5（该分片的 MD5，用于校验完整性） - 服务端收到分片后，应原子性地写入临时目录，并记录到数据库或 Redis，避免并发覆盖
uni-app 客户端分片上传的关键实现点
核心不是“怎么发”，而是“怎么管状态”：分片顺序、失败重试、中断恢复、内存释放。
别用 for 循环直接发所有分片——会阻塞 UI、无法中断、失败后难定位。要用串行或可控并发（比如最多 3 个并发请求）+ Promise 链或 async/await 控制流。
- 每次上传前检查
uploadedChunks数组，跳过已成功的分片索引 - 单个分片失败时，记录错误并 保留当前 uploadId 和已传分片列表，下次恢复时重新拉取最新状态（防止服务端清理超时分片）
- 上传完成前，把
{ uploadId, fileName, fileSize, uploadedChunks }存进uni.setStorageSync；成功后删掉；失败后留着供恢复用 - 小程序中读取大文件务必用
uni.getFileSystemManager().readFile+position+length分段读，别一次性readFile整个文件
常见报错和绕不过去的坑
request:fail net::ERR_CONNECTION_RESET 或 uploadFile:fail timeout 不是网络问题，大概率是分片太大、服务端没配好超时或 Nginx 限制了 body 大小。
- Nginx 需配置：
client_max_body_size 200m、proxy_read_timeout 600、proxy_send_timeout 600 - 微信小程序单个
uni.uploadFile请求最大支持 50MB，但你不用它；而uni.request发送二进制 blob 没有硬性限制，但 iOS WKWebView 对 base64 编码大 blob 有性能陷阱，建议用ArrayBuffer直传 - 安卓 App 端如果用
uni.uploadFile传分片，某些旧版 SDK 会自动加Content-Type: multipart/form-data，和服务端期望的application/octet-stream冲突，导致解析失败——此时必须换uni.request并手动设 header - 断点续传最隐蔽的 bug：客户端按字节偏移切片，服务端却按“分片序号 × 分片大小”算位置，两者不一致会导致文件损坏。务必统一用
chunkIndex+chunkSize计算起始 offset
断点续传真正的复杂度不在“怎么传”，而在“怎么确认每一片都稳稳落盘、不丢不重、可追溯”。MD5 校验、服务端幂等设计、客户端状态持久化，三者缺一不可。少做一步，就可能传完发现文件打不开。
