应使用 multipart.newreader 流式解析请求体，禁用 parsemultipartform，通过 part.open() 获取 io.reader 直传对象存储，配合 http.maxbytesreader 限流与零内存缓冲策略实现不落盘、低内存的流式透传。
怎么让 Go 服务把文件直传到对象存储（比如 OSS/S3），而不是先存本地？
直接走 multipart.FileHeader + io.Copy 到对象存储的 PutObject 接口，绕过本地磁盘。关键不是“上传”，而是“流式透传”——客户端 POST 的二进制流，经 Go HTTP handler 解析后，不落地、不缓冲，直接推给对象存储 SDK。
常见错误是调用 file.Open() 或 file.Read() 把文件读进内存或临时文件，这既拖慢大文件上传，又增加磁盘 I/O 和 OOM 风险。
- 必须用
file.Header.Open()获取io.Reader，不是file.Open() - HTTP 请求体要设置
MaxMultipartMemory为 0（禁用内存缓冲）或极小值（如 32KB），否则 Go 默认用 32MB 内存缓存 multipart 数据 - 对象存储 SDK 的
PutObject必须支持接收io.Reader（AWS SDK v2、aliyun-oss-go-sdk 都支持；老版 aliyun SDK v1 不支持流式，得换
如何处理 multipart 表单里带额外字段（比如 filename、user_id）？
不能依赖 r.FormValue("xxx") —— multipart 解析顺序会影响字段读取，尤其当文件字段在前时，ParseMultipartForm 可能提前消费掉 body 流，导致后续字段读不到或报 http: invalid Read on closed Body。
正确做法：手动遍历 multipart.Reader，按 part header 区分字段和文件。
- 用
r.MultipartReader()拿到*multipart.Reader - 循环
mr.NextPart()，检查part.Header.Get("Content-Disposition")是否含filename=来识别文件 part - 普通字段直接读
part内容（io.ReadAll(part)），注意控制长度防 DOS - 文件 part 留到最后，用它的
io.Reader直连对象存储
上传失败时怎么保证对象存储里不残留半截文件？
对象存储本身不支持“事务上传”，但可以靠预签名 + 分片上传规避中间状态。不过对中小文件（uuid.New().String()），上传成功再写数据库记录；失败就不管——key 不暴露、没业务引用，自然被生命周期策略清理。
如果业务强要求“原子性”，就得用分片上传（CreateMultipartUpload → UploadPart × N → CompleteMultipartUpload），失败时调用 AbortMultipartUpload。
- 普通
PutObject失败 = 对象不存在，无残留 - 分片上传失败必须显式
AbortMultipartUpload，否则碎片会一直计费 - 别在 handler 里做重试——客户端重试会导致重复 key 或重复分片，应由客户端控制幂等
为什么上传大文件时超时或连接重置？
根本原因常是反向代理（Nginx / ALB）或 Go HTTP Server 自身的超时设置太短，而非代码逻辑问题。对象存储上传耗时取决于网络带宽，100MB 文件在 10Mbps 网络下就要 80 秒以上。
- Go server：设置
http.Server.ReadTimeout和WriteTimeout至少 5–10 分钟（注意：Go 1.22+ 已废弃这两个字段，改用ReadHeaderTimeout+IdleTimeout+WriteTimeout组合） - Nginx：调大
client_max_body_size、client_body_timeout、proxy_read_timeout - AWS ALB / 阿里云 SLB：调整空闲超时（idle timeout）和请求超时（request timeout），通常需 > 600s
- SDK 层：AWS SDK v2 默认有 15s 连接超时、30s 传输超时，需显式配置
WithHTTPClient覆盖
这些超时点漏掉任意一个，都会在大文件上传中途断连，且错误日志里往往只显示 “connection reset by peer” 或 “i/o timeout”，看不出真实瓶颈在哪。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
