ctx.PostValue 是获取 application/x-www-form-urlencoded 表单字段最直接安全的方式，自动解析且不 panic；文件上传需先调 ParseMultipartForm，否则 FormFile 返回 nil。
用 ctx.PostValue 拿表单字段最直接
POST 请求提交的 application/x-www-form-urlencoded 表单，Iris 用 ctx.PostValue 获取字符串值，这是最常用、最不容易出错的方式。
它内部做了 ParseForm，不需要手动调用；如果字段不存在，返回空字符串，不会 panic。
-
ctx.PostValue("username")→ 返回string -
ctx.PostValueInt("age", 0)→ 转成int，失败时用默认值0 -
ctx.PostValueFloat64("price", 0.0)→ 同理，带类型转换和兜底
注意：这些方法只对 POST 和 PUT 生效（因为它们可能带 body），GET 请求要用 ctx.URLParam 或 ctx.FormValue（后者需手动 ParseForm）。
ctx.FormFile 处理文件上传必须显式调用 ParseMultipartForm
Iris 不会自动解析 multipart/form-data，不调 ctx.Request().ParseMultipartForm 就直接用 ctx.FormFile，会返回 nil, err —— 这是新手最常踩的坑。
正确写法：
app.Post("/upload", func(ctx iris.Context) {
// 必须先解析，maxMemory 单位是字节
err := ctx.Request().ParseMultipartForm(32 << 20) // 32MB
if err != nil {
ctx.StatusCode(400)
ctx.WriteString("form parse failed: " + err.Error())
return
}
file, header, err := ctx.FormFile("avatar")
if err != nil {
ctx.StatusCode(400)
ctx.WriteString("no avatar field or parse error")
return
}
defer file.Close()
// 保存文件...
})
漏掉 ParseMultipartForm 或传了过小的 maxMemory（比如设成 1），都会导致文件读取失败或内存溢出。
表单绑定结构体推荐用 ctx.ReadForm，但字段名要对齐
想把表单字段批量映射到 struct，用 ctx.ReadForm(&u) 最省事。但它依赖字段标签（tag）和表单 key 名严格匹配：
- struct 字段必须是 exported（首字母大写）
- 默认按字段名小写匹配（
Username→username） - 可用
form:"login_name"标签自定义映射（Username string `form:"login_name"`→ 匹配表单里的login_name） - 不支持嵌套结构体自动展开，深层字段得手动处理
如果表单字段缺失且 struct 字段非指针/非零值类型，ReadForm 不会覆盖原值 —— 它只赋值“能解析成功”的字段，这点和 json.Unmarshal 行为不同。
ctx.PostValue 和 ctx.FormValue 的区别容易混淆
表面上都拿表单值，但底层行为不同：
-
ctx.PostValue：自动触发ParseForm，兼容POST/PUT，安全可靠 -
ctx.FormValue：只是Request.FormValue的封装，**不保证已解析**；若没提前调ParseForm或ParseMultipartForm，返回空字符串且无提示
所以除非你明确控制了解析时机（比如在中间件里统一解析），否则别用 ctx.FormValue —— 它藏了一个“状态依赖”陷阱，调试时很难定位为什么值拿不到。
