FormFile 总是返回 nil 或 http.ErrMissingFile 的根本原因是前端未正确发送 multipart/form-data 请求，后端 name 不匹配或提前解析表单；它返回磁盘临时文件句柄，需手动 Close；多文件需用 MultipartReader；默认 32MB 限制需显式调用 ParseMultipartForm 调整。
FormFile 为什么总是返回 nil 或 http.ErrMissingFile
根本原因几乎都是前端没发对——FormFile 只认 multipart/form-data 编码下的 name 字段，且要求该字段是文件输入控件（<input type="file">）的 name 属性值。如果用了 application/json、application/x-www-form-urlencoded，或者后端查的 name 和前端不一致，就会直接返回 nil, http.ErrMissingFile。
实操建议：
- 前端必须用
<form enctype="multipart/form-data">，不能省略enctype -
<input type="file" name="avatar">→ 后端必须调r.FormFile("avatar")，名字大小写、空格、下划线都要完全一致 - 不要在调
FormFile前手动调r.ParseMultipartForm()或r.ParseForm()——FormFile内部会自动做，提前解析反而可能清空原始 body - 如果前端用 JS 的
FormData.append("file", blob)，确保 key 名（这里是"file"）和后端FormFile参数一致
FormFile 返回的 *os.File 是临时文件，不是内存缓冲
FormFile 返回的 file 是一个指向磁盘临时文件的句柄（路径类似 /tmp/xxx），不是上传内容的内存副本。这意味着它支持 Seek、Stat，但生命周期只到本次请求结束；你不显式 Close()，Go 会在请求结束时自动清理，但不关可能影响后续读取（比如重复 io.Copy）。
实操建议：
- 务必在用完后
defer file.Close()，否则第二次io.Copy会失败（seek from invalid position） - 别假设文件还在磁盘——它只是临时存在，不能跨请求访问
- 如果只需要文件名或大小，优先用
header.Filename和header.Size，避免打开文件 - 想读内容又不想写磁盘？改用
r.MultipartReader()+reader.NextPart()手动解析，绕过临时文件机制
多个同名文件时 FormFile 只返回第一个
FormFile 设计就是单文件语义：遇到多个同名 <input type="file" name="photos" multiple> 上传，它只取第一个 part，其余被忽略。这不是 bug，是 API 定义如此。
实操建议：
- 要处理多文件，必须用
r.MultipartReader()，循环NextPart()，检查每个 part 的Header.Get("Content-Disposition")是否含name="photos" - 或者前端把多个文件拆成不同
name（如photo1、photo2），后端分别调FormFile - 注意：
multipart.Reader不会自动解析boundary，r.MultipartReader()才会正确提取
文件过大导致 ParseMultipartForm panic 或超时
FormFile 底层依赖 ParseMultipartForm，而后者默认只允许 32MB 以内数据，超过就 panic：http: request body too large。这个限制不是靠 Context 控制，而是由 Request.MaxMemory 决定。
实操建议：
- 在调
FormFile前，显式设置：r.ParseMultipartForm(10 （10MB），或 <code>r.MultipartReader()前设r.ParseMultipartForm(0)关闭内存限制（但要自己流式处理） - 更安全的做法：在 handler 开头就设
r.ParseMultipartForm(32 ，再调 <code>FormFile - 别依赖全局
http.DefaultMaxHeaderBytes——它管 header，不管 body - 生产环境必须配合反向代理（如 Nginx）的
client_max_body_size，否则请求根本到不了 Go
真正容易被忽略的是：前端 enctype 错了，后端却以为是逻辑问题去查路由或中间件；还有人反复 Close() 同一个 *os.File 导致 panic；多文件场景硬套 FormFile 结果只拿到第一个——这些都不是 Go 的问题，是 multipart 协议和 API 边界没理清。
