ctx.formvalue 读不到 multipart 表单字段，因其仅支持 application/x-www-form-urlencoded；对 multipart/form-data 必须先调用 ctx.parsemultipartform 或 postform 等方法触发解析，否则字段为空且 multipartform 为 nil。
为什么 ctx.FormValue 读不到 multipart 表单里的字段？
因为 ctx.FormValue 只适用于 application/x-www-form-urlencoded，对 multipart/form-data 无效——Gin 不会自动解析 multipart body，必须显式调用解析方法，否则所有字段都为空。
常见现象：前端用 FormData 提交，后端打印 ctx.PostForm("name") 却始终是空字符串，ctx.Request.MultipartForm 也 nil。
- 必须先调用
ctx.ParseMultipartForm或触发任意一个PostForm*方法（如PostForm、FormFile），Gin 才会真正解析 multipart body -
ParseMultipartForm的参数是最大内存阈值（单位字节），超过该值的字段会写入临时文件；设为 0 或太小会导致解析失败或 panic - 建议设为合理值，例如
32 （32MB），避免内存溢出又兼顾小表单效率
如何安全读取 text 字段和 file 字段混合的 multipart 表单？
不能混用 PostForm 和 FormFile 顺序随意调用：Gin 内部只解析一次 multipart body，首次调用任一解析方法后，后续调用才有效；但若先调 FormFile 再调 PostForm，字段可能丢失（尤其当文件较大、触发磁盘写入时）。
- 统一用
ctx.MultipartForm()一次性获取全部字段和文件，最稳妥 - 它返回
*multipart.Form，其中Value是map[string][]string，File是map[string][]*multipart.FileHeader - 注意：调用
MultipartForm()前仍需确保已调用ParseMultipartForm，否则会返回 error
示例：
if err := ctx.ParseMultipartForm(32 <h3> <code>ctx.SaveUploadedFile</code> 保存文件时容易踩哪些坑？</h3> <p>这个方法看似简单，但路径处理和并发安全常被忽略。</p>
- 目标路径必须是绝对路径或相对于可执行文件路径；如果传相对路径如
"uploads/a.jpg"，实际保存位置取决于进程启动目录，不是项目根目录 - 建议用
filepath.Join拼接，并提前os.MkdirAll创建目录，否则报no such file or directory - 多个文件上传时，
SaveUploadedFile不是并发安全的——它内部调用os.Create，若多个协程同时保存同名文件，后者会覆盖前者 - 务必对文件名做清理（如去掉路径遍历字符
../），否则可能写入任意位置
安全写法示例：
dst := filepath.Join("./uploads", cleanFilename(header.Filename))
if err := os.MkdirAll(filepath.Dir(dst), 0755); err != nil {
ctx.JSON(500, gin.H{"error": "mkdir failed"})
return
}
if err := ctx.SaveUploadedFile(header, dst); err != nil {
ctx.JSON(500, gin.H{"error": "save failed"})
return
}
上传大文件时 Gin 默认限制怎么绕过？
Gin 自身不限制大小，但底层 net/http 默认 MaxMultipartMemory = 32 （32MB），超出部分会写入临时文件；而操作系统临时目录空间不足、或临时文件未清理，会导致上传失败。
- 修改全局 http.Server 的
MaxMultipartMemory：在启动 Gin 之前，通过gin.SetMode(gin.ReleaseMode)等设置后，用router.Run()底层其实是http.ListenAndServe，需自己构造http.Server - 更直接的方式：在路由 handler 开头调用
ctx.Request.ParseMultipartForm并传入更大的 limit（比如100 ），这会覆盖默认值 - 但注意：limit 只控制内存缓冲上限，不等于总上传限制；真正限制上传大小，还得靠中间件校验
Content-Length头，或用ctx.Request.ContentLength判断
真正要拦住超大请求，得在读 body 前就拒绝：
if ctx.Request.ContentLength > 100 Gin 解析 multipart 的关键点不在“怎么写”，而在“什么时候触发解析”和“解析后怎么用”。很多人卡在第一次调用失败，其实只是忘了 <code>ParseMultipartForm</code> 这一步；更隐蔽的问题是混合字段读取顺序和文件名信任问题——这些地方不写测试很难暴露。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
