multipart.FormValue 拿不到文件字段，因为它仅解析非文件类表单字段；文件需通过 multipart.FormFile 或先调用 ParseMultipartForm 再访问 FileHeader。
为什么 multipart.FormValue 拿不到文件字段？
因为 multipart.FormValue 只读取非文件类表单字段（如文本输入），而文件字段必须通过 multipart.FormFile 或先调用 ParseMultipartForm 再访问 multipart.FileHeader。常见错误是直接对 *http.Request 调用 FormValue，却没意识到文件内容根本不在 Form 值里。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须先调用
r.ParseMultipartForm(32 （例如限制 32MB），否则 <code>FormFile和MultipartForm字段为空 - 若只读一个文件，用
file, header, err := r.FormFile("upload")最简洁；若需同时读多个文件或混合字段，应统一走r.MultipartForm -
ParseMultipartForm的参数是内存缓冲上限，超过该值会自动写入临时磁盘文件——不是总能避免 IO，只是控制何时落盘
如何安全地保存上传的 *multipart.File？
拿到 multipart.File 后不能直接用 io.Copy 到任意路径，否则易受路径遍历攻击（如 ../../../etc/passwd）。关键在于校验 header.Filename 并生成可控文件名。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远用
path.Base(header.Filename)截掉路径部分，丢弃原始路径信息 - 用
uuid.New().String()或时间戳 + 随机数重命名，避免冲突和猜解 - 显式指定保存目录（如
/var/uploads），并确保该目录不可执行、无 Web 目录映射权限 - 检查
header.Size是否在合理范围内（如
为什么上传大文件时连接被重置或超时？
Golang 默认 HTTP server 的 ReadTimeout 和 WriteTimeout 很短（通常 30 秒），而大文件上传可能耗时更久；同时客户端（如 curl、浏览器）也可能主动断连。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 设置
http.Server.ReadTimeout和ReadHeaderTimeout为足够值（如 5 分钟），注意WriteTimeout不影响上传过程，只影响响应写出 - 使用
context.WithTimeout在 handler 内部控制处理时长，避免单个慢请求阻塞整个服务 - 生产环境建议搭配反向代理（如 Nginx）做超时管理与静态文件卸载，并配置
client_max_body_size和client_body_timeout
如何支持多文件同名字段（如 name="files" 多次出现）？
HTML 表单中多个 <input type="file" name="files"> 会被合并为同一 key 的多个值，但 r.FormFile("files") 只返回第一个。必须用 r.MultipartForm.File["files"] 才能拿到全部。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先调用
r.ParseMultipartForm(maxMemory)，再访问r.MultipartForm.Filemap - 遍历
r.MultipartForm.File["files"]得到一组multipart.FileHeader，每个再调用Open()获取multipart.File - 注意：
r.MultipartForm.Value存放普通字段，r.MultipartForm.File存放文件字段，二者独立
真正麻烦的不是解析 multipart，而是边界控制——文件名净化、大小限制、存储隔离、超时分级、临时文件清理。这些点漏掉任意一个，都可能让上传接口变成突破口。
