go语言云存储上传限速必须在文件流被真正读取时插令牌桶，即作用于multipart.part.read或*os.file.read路径，而非http客户端或请求体外层；用ratelimit.reader最简捷，手动实现需rate.limiter+io.pipe并严格配对reserven与wait。
Go语言中做云存储上传限速，关键不是在HTTP客户端配超时或重试，而是在文件流被真正读取写入的那一刻插令牌桶——否则 multipart 预读、client 缓冲、分块重试都会绕过限速逻辑。
限速必须发生在 multipart.Part.Read 或 *os.File.Read 调用路径上
所有试图在 handler 外层包装 http.Request.Body 或用 io.LimitReader 包裹整个请求体的做法都无效。因为 multipart.Reader 会提前把 boundary 和 headers 解析完，实际文件数据还没开始读，限速就已失效。
-
multipart.Part是真正的数据消费者，限速 Reader 必须直接套在它上面 - 如果用
minio.Core.PutObject上传，限速要加在传入的io.Reader参数上，而不是 client 或 transport 层 - MinIO 的
PutObject内部会多次调Read，所以限速器必须支持重复调用且不漂移
用 ratelimit.Reader 最省事，但要注意桶容量设置
第三方库 github.com/juju/ratelimit 提供开箱即用的封装，比手写 rate.Limiter + io.Pipe 更可靠，尤其适合直接对接 multipart.Part。
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 示例：
limitedPart := ratelimit.Reader(part, ratelimit.NewBucketWithRate(2*1024*1024, 2*1024*1024))表示限速 2MB/s，桶容量也是 2MB - 桶容量太小（比如设为 1KB）会导致小文件上传卡顿，因为每次
Read都要等令牌；太大（比如 100MB）则突发流量压制不足 - 它内部已处理
io.Seeker和io.ReaderAt场景，支持 Range 请求，io.LimitReader不支持这点
手动用 rate.Limiter + io.Pipe 时，ReserveN 和 Wait 必须配对出现
当你需要插入监控、熔断或 context 取消逻辑时，就得自己控制节奏。漏掉 limiter.ReserveN 或没调 res.Wait(ctx)，限速就等于没做。
- 每次
Read(p []byte)前，必须调res := limiter.ReserveN(time.Now(), len(p))，不能复用旧时间戳 -
res.Wait(ctx)必须紧跟其后，且ctx要来自上传请求本身，不能是context.Background() - 必须用
io.Pipe：写端 goroutine 负责从原始 part 读、经限速后写入 pipe，读端交给PutObject或io.Copy；否则multipart多次Read会触发重复 Reserve，速率翻倍 -
pipeWriter.Close()必须由写端 goroutine 在读完后主动调，否则读端永远阻塞在Read
MinIO 分片上传场景下，限速要落在每个分片的 io.Reader 上
MinIO 的 core.PutObjectPart 接收的是单个分片的 io.Reader，不是整个文件。限速不能只做一次，而是每个分片都要单独限速。
- 不要在创建
minio.Core时统一限速，那是无意义的——transport 层限速不生效 - 生成 presigned URL 后，客户端上传每个分片时，服务端接收该分片的 handler 里，要对对应
part做限速包装 - 若用
minio-go/v7的高级 API（如PutObject），它内部会自动分片，此时限速要加在你传入的io.Reader上，且确保该 Reader 支持多次Read - 注意：MinIO 默认分片大小是 5MB，限速值应按单个分片吞吐设计，比如限 5MB/s 就刚好匹配一个分片在 1 秒内写完
真正容易被忽略的点是：限速对象不是“请求”，而是“字节被消费的瞬间”。无论你用 MinIO、S3 还是自建对象存储，只要上传路径里存在任意一层缓冲（multipart parser、gzip reader、TLS record layer），限速就必须插在最靠近磁盘写入的那一环，否则再精细的配置也挡不住流量毛刺。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
