Go文件上传内存暴涨需禁用ParseMultipartForm，用mime.MultipartReader流式处理；下载卡住须设Header并手动Flush或用ServeContent；中文名乱码应优先解析filename*并DecodeWord；进度与断点续传需自定义Reader及分块协议。
Go HTTP 文件上传时内存暴涨，怎么避免读全量到内存
Go 默认用 req.ParseMultipartForm 会把整个文件先缓存进内存或临时磁盘，大文件上传时极易 OOM 或拖慢服务。根本解法是绕过自动解析，直接读原始 req.Body 流。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 调用
req.ParseMultipartForm(0)禁用自动解析（传 0 表示不限制但不分配内存缓冲） - 用
mime.MultipartReader手动解析 boundary，逐 part 处理；对Content-Disposition中含filename=的 part，直接用io.Copy写入磁盘或转发 - 务必设置
http.MaxBytesReader包裹req.Body，防恶意超长 body 耗尽内存 - 别依赖
req.FormFile—— 它内部会触发完整解析，大文件场景下等同于自毁
Go 下载大文件卡住或超时，为什么 ResponseWriter 没反应
常见现象是浏览器进度条不动、curl 卡在 “Waiting for server”，本质是 Go 的 http.ResponseWriter 默认不主动 flush，且未设置正确 header 导致客户端无法流式接收。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须提前写 header：
w.Header().Set("Content-Type", "application/octet-stream")和w.Header().Set("Content-Disposition", `attachment; filename="xxx"`) - 对大文件，禁用 gzip 压缩：
w.Header().Set("Content-Encoding", "identity")，否则gzip.Writer会缓冲直到 close - 用
http.ServeContent替代手动io.Copy，它会自动处理If-Range、Range请求和 206 响应，且内部带 chunked flush - 若必须手动 copy，每写完一个 buffer（如 32KB）后调用
w.(http.Flusher).Flush()，确保底层 TCP 发包
multipart/form-data 上传中 filename 编码乱码，中文名变成
不是 Go 的 bug，是 RFC 7578 允许两种 filename 字段格式：普通 filename="中文.txt"（无编码，依赖客户端编码）和带 filename*=UTF-8''... 的 encoded-word 格式。Go 的 mime.WordDecoder 不自动处理后者。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 解析
Content-Dispositionheader 时，优先检查是否存在filename*key，再 fallback 到filename - 对
filename*值，用mime.DecodeWord解码（注意它只解单个 word，需自己 split'分隔符） - 不要用
strings.Trim或正则硬切引号 —— RFC 允许引号内含转义，必须走标准解析 - 浏览器端上传中文名一般发
filename*，但某些旧 Postman 或 curl 版本只发filename，此时需约定统一 UTF-8 编码并告知前端
流式上传下载如何加进度回调和断点续传支持
Go 标准库不提供上传/下载进度钩子，也不能直接 resume 已中断的 multipart 上传。要支持，得在应用层做状态透出和协议适配。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 上传进度：包装
req.Body为自定义io.Reader，每次Read后调用回调函数更新 DB 或 Redis 中的 upload_id 进度 - 下载进度：同理包装目标文件的
*os.File或网络 reader，但注意避免在高并发下频繁写进度导致 I/O 瓶颈 - 断点续传上传：放弃 multipart，改用分块上传（如 TUS 协议），用
PUT /files/{id}/chunks/{offset}接口，每个块独立校验，最后合并 - 断点续传下载：客户端发
Range: bytes=1000-，服务端用http.ServeContent自动支持；关键是要让客户端记住上次 offset，这得靠前端逻辑维护
真正难的不是代码怎么写，而是 multipart 协议本身不带 offset/length 元信息，所有“进度”和“续传”都得靠你在协议外补状态、补接口、补存储。别指望一个 ParseMultipartForm 调用能解决这些。
