go处理大文件分片上传时须禁用框架默认parsemultipartform，因其提前读空request.body导致分片数据丢失；应设r.parsemultipartform(0)，避免调用c.formfile等方法，元信息从url或query获取，并手动流式处理raw body。
Go 处理大文件分片上传，不能依赖框架默认的 ParseMultipartForm 行为——它会提前消费 request.Body，导致分片数据读不到。必须绕过自动解析，手动流式处理，否则上传必失败。
为什么 Gin/echo 等框架默认行为会吞掉分片数据
框架在中间件或 handler 入口常隐式调用 ParseMultipartForm（比如 Gin 的 c.FormFile、c.MultipartForm），一旦触发，r.Body 就被读空，后续再 io.Copy 或 io.ReadAt 都返回 EOF。这不是 bug，是设计使然。
- 必须在框架路由 handler 最开头就禁用解析：
r.ParseMultipartForm(0)（传 0 表示跳过 multipart 解析） - 若用 Gin，别在 handler 里调
c.FormFile或c.PostForm；元信息统一从 URL 查询参数或r.URL.Query().Get("upload_id")、r.FormValue("chunk_index")获取 - 如果用了第三方中间件（如
gin-contrib/multiform），检查它是否内部调用了ParseMultipartForm；有则禁用或替换
如何在框架中安全接收 raw body 分片
分片请求的 Content-Type 应为 application/octet-stream，不是 multipart/form-data。框架默认不支持 raw body 解析，需显式接管。
- 先限流防攻击：
r.Body = http.MaxBytesReader(w, r.Body, 5（限制单片 ≤5MB） - 用
io.CopyN或io.LimitReader(r.Body, expectedSize)读取精确字节数，避免读超或阻塞 - 写入临时文件时用
os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_EXCL)，防止并发写同一分片覆盖 - Gin 示例：
c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, 5 必须在 <code>c.Request.ParseMultipartForm(0)之前执行
框架里怎么管理 uploadId 和分片状态
框架本身不提供上传上下文存储，你得自己选：内存 map（单机）、Redis（多实例）、或本地磁盘文件。关键不是存哪，而是“查”和“判”的逻辑不能错。
- 收到分片前，先查该
upload_id对应的已接收索引集合（如redis.SMembers("upload:abc123:parts")），重复或越界直接http.Error(w, "duplicate chunk", 409) - 不要只靠前端传的
total_chunks判断是否完成；合并前必须redis.SCard("upload:abc123:parts") == total_chunks - 断点续传时，前端轮询
/status?upload_id=xxx，后端返回已传成功的part_number列表（升序 int slice），前端据此决定从哪片继续 - uploadId 生命周期要明确：创建后 24 小时未完成则自动清理，避免磁盘堆积
合并操作为什么不能放在 HTTP handler 里同步执行
合并多个 GB 文件可能耗时数秒，若在 handler 中直接 os.Open 所有分片再 io.Copy，会阻塞 goroutine，拖垮整个服务吞吐量。
- 接收完最后一片后，只返回
{"status":"merged_pending","upload_id":"..."}，立即 spawn goroutine 异步执行合并 - 合并过程需加锁（如
sync.Mutex或 Redis lock），防止同一upload_id被多次触发 - 合并失败（如某分片文件丢失、哈希校验不匹配）必须删掉目标文件 + 所有分片，不留脏数据
- 进度暴露接口（如
/progress?upload_id=xxx）应查内存 map 或 Redis 中的upload:abc123:merged字段，而非实时扫描文件系统
最易被忽略的是：分片文件写入后没做 file.Sync() 或 os.File.Close()，在机器宕机时导致部分分片内容丢失；而合并时又只检查文件存在与否，不验证 fi.Size() > 0，结果静默拼出损坏文件。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
