multipart.ReadForm 只读到部分字段是因为默认内存缓冲限制为10MB，超出时转存临时文件，若未调用ParseMultipartForm或参数过小会导致Form字段为空；建议在读取前调用r.ParseMultipartForm(32<<20)。
multipart.ReadForm 为什么只读到部分字段？
因为 ReadForm 默认限制内存缓冲大小（10MB），超出部分会自动转存临时文件，但若未显式调用 ParseMultipartForm 或参数设得太小，Form 字段可能为空或缺失。
实操建议：
- 必须在读取请求体前调用
r.ParseMultipartForm(32 （例如 32MB），否则 <code>r.Form和r.MultipartForm可能不完整 - 若仅需解析而不保存文件，可设较小值（如
1 ），但注意文本字段若含大量 JSON 或 base64 也会计入该限制 - 调用后务必检查错误：
if err != nil { /* "invalid multipart format" 或 "http: request body too large" */ }
如何安全读取 multipart 表单中的文本字段？
别直接依赖 r.FormValue("key") —— 它只返回第一个同名字段，且对多值、非 UTF-8 编码或含空格的键名不可靠。
正确做法是通过 r.MultipartForm.Value["key"] 获取全部值，并手动处理：
立即学习“go语言免费学习笔记（深入）”；
-
r.MultipartForm是解析后的结构体，需先确保已调用ParseMultipartForm - 文本字段值默认按 RFC 7578 解码，但不会自动 trim 或转义；若前端用
encodeURIComponent发送，Go 不会自动 decode，需手动调用url.QueryUnescape - 避免用
io.ReadAll直接读part的 Body——文本字段的Header中Content-Type通常是text/plain，但无意义；真正类型由前端FormData.append(key, value)决定
读取文件时 part.Header.Get("Content-Disposition") 解析失败？
因为 Go 的 mime/multipart 不自动解析 filename 参数，part.FileName() 才是唯一可靠方式。
常见陷阱：
-
part.Header.Get("Content-Disposition")返回原始字符串（如form-data; name="file"; filename="中文.txt"），手动解析易出错（引号、分号、编码） -
part.FileName()内部已处理 RFC 5987（带编码的 filename*）和普通 filename，应始终优先使用 - 若
part.FileName() == ""，说明该 part 是文本字段而非文件，不要尝试io.Copy到磁盘 - 文件名可能含路径（如
../../etc/passwd），务必清理：filepath.Base(filename)，且禁止拼接进绝对路径
内存 vs 临时文件：ParseMultipartForm 的 maxMemory 怎么设？
这个参数不是“最大上传体积”，而是“最多多少字节留在内存里”；超过部分写入 os.TempDir()。设太小会导致频繁磁盘 I/O，设太大可能 OOM。
推荐策略：
- 纯文本表单（如含大段 Markdown 或 JSON）：设
10 （10MB）足够 - 含小文件（头像、PDF）：按典型文件大小 × 并发数估算，例如 2MB × 10 并发 ≈ 20MB
- 生产环境务必设置上限（如
64 ），并配合 Nginx 的 <code>client_max_body_size做前置拦截，避免恶意构造超大 form-data 耗尽内存 - 临时文件不会自动清理，
r.MultipartForm.RemoveAll()应在 handler 结束后显式调用（尤其长连接或中间件场景）
实际解析逻辑里最易被跳过的环节，是确认 r.MultipartForm 非 nil 且已成功填充——很多 panic 源于没检查 ParseMultipartForm 错误就直接访问 Value 或 File 字段。
