必须在handler开头用http.MaxBytesReader限流并调r.ParseMultipartForm(32)启用内存阈值，元数据从URL或header提取，分片流式写入临时路径，合并前校验ETag、PartNumber和顺序，集群状态用Redis同步，并发上传需信号量限流。
Go微服务里怎么接住大文件分片而不崩
直接读 r.Body 或用 io.ReadAll 必然 OOM，微服务资源更敏感，1GB 文件就可能拖垮整个 Pod。关键不是“能不能传”，而是“怎么让请求体不冲垮内存和连接”。
- 必须在 handler 开头立刻替换
r.Body：r.Body = http.MaxBytesReader(w, r.Body, 2*1024*1024*1024)（限 2GB） -
r.ParseMultipartForm(32)是安全阈值：32MB 内存缓冲，超量自动落盘到os.TempDir()，设为 0 会跳过 multipart 解析，设为 500 就等着被并发打穿 - 别碰
r.MultipartForm.File后再处理——它内部已读过部分 body，r.Body可能已失效；元数据（如upload_id、chunk_index）一律从 URL query 或 header 提取，二进制流直接从r.Body流式写入 - 临时分片路径建议用
./uploads/{upload_id}/{chunk_index}，避免单目录堆积成千上万文件导致filepath.Glob变慢甚至失败
为什么分片合并总出错：ETag、PartNumber、顺序三者缺一不可
MinIO/S3 兼容对象存储的 CompleteMultipartUpload 不接受“差不多对”，错一个字段就报 InvalidPart 或静默丢片。这不是 Go SDK 问题，是协议强制要求。
-
PartNumber必须从 1 开始连续整数，不能用 0 起始，也不能跳号（比如传了 1、2、4，服务端拒绝合并） - 每个分片上传后，MinIO 返回的
ETag（不是你本地算的 MD5）必须原样记下；合并时按PartNumber升序排列，逐个填入minio.CompletePart列表 - 调
minioCore.CompleteMultipartUpload前，先用minioCore.ListParts拉一遍已传分片，校验数量和序号是否匹配——断点续传或网络乱序时这步不能省 - MinIO 的
ETag是 base64 编码的 MD5，但某些客户端（如浏览器 fetch）可能传原始 hex，服务端需统一转换或校验逻辑对齐
微服务场景下如何做断点续传和状态同步
单机服务可用 sync.Map，但微服务集群里 upload_id 状态必须共享，否则用户切到另一实例就找不到已传分片。Redis 是最轻量可靠的选择，别自己造轮子。
- 收到分片时，用
redis.SADD("upload:{upload_id}:parts", chunk_index)记录；查询状态时用redis.SMEMBERS拉全量，毫秒级响应 - 每个分片上传成功后，立即更新
redis.EXPIRE("upload:{upload_id}", 7*24*3600)（7 天 TTL），避免死 upload_id 占满内存 - 提供
/status?upload_id=xxx接口，返回{"uploaded": [1,2,4], "total": 10}，前端据此只重传缺失索引，不依赖本地缓存 - 合并完成后，用
redis.DEL("upload:{upload_id}:parts")清理，别等 TTL——避免误判“还在上传中”
并发上传时 goroutine 和 HTTP 连接怎么不互相卡死
开 100 个 goroutine 直接发 HTTP 请求，不出 10 秒就会触发 too many open files 或 MinIO 限频 429。瓶颈不在 CPU，而在文件描述符和连接复用。
- 用信号量控并发：
sem := make(chan struct{}, 3)，每个上传前sem ，完成后 -
http.Client.Transport.MaxIdleConnsPerHost至少设为并发数（如 10），否则连接无法复用，每请求新建 TCP，耗尽端口和 TIME_WAIT - 分片上传前，对源文件句柄调
f.Seek(offset, io.SeekStart)定位，再用io.LimitReader(f, size)构造 body——避免多个 goroutine 争抢同一文件指针 - 别在循环里反复
os.Open大文件，打开一次复用到底；关闭时机放在所有分片上传完之后
真正容易被忽略的是：MinIO 的 uploadId 有生命周期（默认 7 天），而 Redis 的 key 过期策略必须和它对齐；另外，Content-Length header 在每个分片请求里都得准确，否则 Nginx 等中间件可能截断或拒收——这事跟 Go 代码无关，但没配对就永远卡在 99%。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
