r.parsemultipartform() 不适合大文件上传，因为它将所有非文件字段全加载进内存，并以参数值为上限限制内存缓冲（如32mb），超限部分虽落盘但无法规避oom风险，且不支持分片、流控与落盘路径自定义。
直接用 http.FileServer 或 c.Request.FormFile() 处理大文件上传，必然失败——前者不支持 POST，后者会把整个文件读进内存，1GB 文件就占 1GB RAM，还无法做分片、去重、跨节点路由。
为什么 r.ParseMultipartForm() 不适合大文件
它内部调用 ReadForm，把所有非文件字段全加载进内存，并限制整个表单大小（比如 r.ParseMultipartForm(32 表示最多 32MB）。你传一个 2GB 文件 + 若干文本字段，它先分配内存存字段，再报 <code>http: request body too large，根本到不了文件处理逻辑。
- 生产环境必须绕过
ParseMultipartForm，改用multipart.NewReader(r.Body, boundary)手动流式解析 - 每个
part要立刻判断类型：part.FormName() == "file"才处理，其余字段可跳过或丢弃 - 文件部分默认写入
/tmp，但你无法控制路径、命名和生命周期——必须自己接管io.Copy目标 - Gin 用户尤其注意：
c.Request.FormFile()底层就是ParseMultipartForm，别用
如何安全接收并路由到分布式节点
客户端上传时需带必要元数据：X-File-Hash（sha256）、X-File-ID（唯一标识）、X-Node-Routing（可选，用于强制路由），服务端不做信任校验，只作路由依据。
- 先查元数据服务（如 etcd 或 PostgreSQL）：该
X-File-Hash是否已存在？若存在，直接返回 304 或硬链接，跳过写入 - 若不存在，按一致性哈希（
hash(fileID) % N）或预设规则决定存哪台节点，再用 HTTP redirect 307 或反向代理转发请求（避免客户端重复构造 body） - 不要在接收 handler 里直接
http.Post转发——body 是单次读取流，转发前已关闭，会读不到数据 - 真正写入时，用
os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)追加分片，而非覆盖；多分片并发写同一文件名必须加文件锁（flock）或用唯一临时名再原子 rename
并发上传时怎么避免 goroutine 和连接爆炸
起 100 个 go upload() 看似简单，实际会迅速耗尽本地端口、触发 DNS 超时、被服务端限流 429，甚至让 http.Client 的连接池瘫痪。
- 全局复用一个
http.Client，设置Transport.MaxIdleConnsPerHost = 100（别用默认的 2） - 用带缓冲 channel 做并发令牌：
sem := make(chan struct{}, 10)，每个上传任务先sem ，完成后 <code> - 每个请求必须带
context.WithTimeout(ctx, 5 * time.Minute)，超时后主动关闭 pipe 或中断读取 - 上传 body 必须用
io.Pipe+multipart.Writer流式构造：开 goroutine 写入pw，主流程从pr读取提交，避免内存堆积 - 别漏
pw.Close()—— 否则http.Do会永远卡在读 body 上
分片合并与最终校验不能省略
客户端分片上传只是开始，服务端合并才是关键。没校验的合并等于没上传——可能缺片、乱序、写错 offset，最终文件不可用。
- 合并前检查本地是否存在全部分片（如
0001.bin,0002.bin…），缺任一片直接 400，不尝试凑合 - 用
os.OpenFile(finalPath, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644)清空目标，再按序io.Copy(dst, os.Open(piece)) - 合并完立刻重新打开 final 文件，用
sha256.New()+io.Copy计算总哈希，与客户端传来的X-Final-SHA256对比 - 校验失败必须立刻删掉 final 文件 + 所有分片——留着脏数据比报错更危险
- 别用
cat或 shell 命令合并：不可控、无校验、难调试
真正的难点不在“怎么传”，而在“怎么确保每一片都落到该落的位置、顺序不错、内容不烂、节点挂了还能续”。这些细节没有银弹，全靠对 io.ReadAt、multipart.Reader、http.Transport 和分布式协调逻辑的精确控制。稍一松懈，上传成功率就断崖下跌。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
