Fiber 的 c.FormValue() 仅对正确 Content-Type 的 application/x-www-form-urlencoded 和 multipart/form-data 自动解析；若 Content-Type 错误、body 已被消费或手动构造 multipart boundary 失败，均返回空字符串；c.PostForm() 是其完全等价别名；上传文件必须用 c.MultipartForm() 统一获取字段与文件。
Fiber 默认不自动解析表单数据以外的格式，但对 application/x-www-form-urlencoded 和 multipart/form-data 是开箱即用的——只要 Content-Type 正确，c.FormValue() 就能直接取值。
为什么 c.FormValue("name") 有时返回空字符串
常见错误是前端没发对 Content-Type：
• 如果用 fetch 发送表单但没设 headers: { "Content-Type": "application/x-www-form-urlencoded" }，浏览器默认用 text/plain，Fiber 就跳过解析，c.FormValue() 返回空
• multipart/form-data 必须带正确的 boundary，手写 body 容易出错；推荐用 FormData 对象自动构造
• 调用过 c.BodyParser() 或 c.Body() 后再调 c.FormValue()，body 已被消费，结果为空（Fiber 不缓存原始 body）
c.FormValue() 和 c.PostForm() 有啥区别
二者行为完全一致，c.PostForm() 是别名，无额外逻辑。
实际使用建议：
-
c.FormValue("field")：最常用，返回string，字段不存在时返回空字符串 -
c.FormValue("field", "default")：支持默认值（注意：这是 Fiber v2.48+ 才加的签名，旧版不支持） - 想严格区分“未传”和“传了空字符串”，得用
c.Request().MultipartForm手动检查Valuemap 是否包含 key - 不要对同一请求混用
c.FormValue()和c.Body()—— 后者会提前读走整个 body，导致前者失效
上传文件时怎么同时取表单字段和文件
必须用 multipart/form-data，且所有字段（包括文本）都通过 c.MultipartForm() 统一获取：
form, err := c.MultipartForm()
if err != nil {
c.Status(400).SendString("parse error")
return
}
// 文本字段
names := form.Value["name"] // []string
if len(names) > 0 {
name := names[0]
}
// 文件字段
files := form.File["avatar"] // []*multipart.FileHeader
if len(files) > 0 {
if err := c.SaveFile(files[0], "./uploads/"+files[0].Filename); err != nil {
c.Status(500).SendString("save failed")
return
}
}
注意：
• c.FormValue() 在 multipart 场景下不可靠，它只从 form.Value 的副本里取，而副本可能未完整填充
• c.MultipartForm() 内部会调用 ParseMultipartForm，若未显式调用，首次访问 form.Value 或 form.File 会触发解析
• 文件大小限制需提前设：app.Use(func(c *fiber.Ctx) error { c.Locals("maxMemory", 32，否则默认 32MB，超限直接 400
表单绑定到结构体该用哪个方法
Fiber 没有类似 Gin 的 ShouldBind 自动识别 Content-Type 的绑定器，表单数据必须手动提取后赋值：
- 不推荐用
c.BodyParser(&v)处理表单——它只认 JSON/XML，对x-www-form-urlencoded会静默失败（v保持零值） - 正确做法：定义结构体，逐个调
c.FormValue()并转换类型（如strconv.Atoi），或用第三方库如go-playground/validator手动校验 - 如果坚持结构体绑定，可封装一个辅助函数：
ParseForm(c *fiber.Ctx, dst interface{}) error，内部遍历 struct tag（如form:"age"）并调c.FormValue()，再反射赋值 - 路径参数（
:id）、查询参数（?page=2）和表单字段三者来源不同，不能混用同一个绑定逻辑
最易被忽略的一点：Fiber 对表单的处理完全依赖底层 fasthttp 的 ParseMultipartForm 和 ParseForm，它们不支持嵌套字段（如 user[name]），遇到就当普通字符串键处理——真要嵌套，得自己解析 key 名称或换 JSON 传。
