用 ctx.postvalue 获取表单字段最直接，它自动解析并缓存请求体；误用 urlparam 或 queryvalue 无效；postvaluedefault 和 postvalueint 可设默认值与转类型；readform 支持结构体绑定但需导出字段和 form tag；文件上传须用 formfile；csrf 和空值校验需手动实现。
用 ctx.PostValue 拿字符串表单字段最直接
POST 表单提交（application/x-www-form-urlencoded）时，Iris 通过 ctx.PostValue 提取字段值，它内部自动解析 ctx.Request().Body 并缓存结果，多次调用不会重复读取流。
常见错误是误用 ctx.URLParam 或 ctx.QueryValue 去取 POST 表单——它们分别对应路径参数和 URL 查询参数，完全不生效。
-
ctx.PostValue("username")返回string，若字段不存在则返回空字符串 - 需要默认值？用
ctx.PostValueDefault("age", "18") - 要转整型？直接上
ctx.PostValueInt("age", 0)，失败时返回默认值，不用手动strconv.Atoi - 注意：前端
<input name="email">的name属性必须和PostValue的键完全一致（区分大小写）
ctx.ReadForm 适合结构化绑定，但有前提条件
如果你的表单字段多、类型杂，又不想一个个手写 PostValueXXX，可以用 ctx.ReadForm(&user) 批量绑定到 struct。但它要求：
- struct 字段必须是导出的（首字母大写）
- 需打 tag，比如
Username string `form:"username"`，tag 名要和表单name匹配 - 不支持嵌套 struct 绑定（如
Address.City），只能平铺一级字段 - 如果表单里有字段在 struct 中不存在，Iris 默认忽略，不会报错——容易漏掉拼写错误
示例：
type LoginForm struct {
Username string `form:"username"`
Password string `form:"password"`
Remember bool `form:"remember"`
}
func login(ctx iris.Context) {
var form LoginForm
if err := ctx.ReadForm(&form); err != nil {
ctx.StatusCode(400)
ctx.WriteString("form parse failed")
return
}
// ...
}
文件上传要用 ctx.FormFile，别混进普通表单逻辑
含 <input type="file"> 的表单，Content-Type 会变成 multipart/form-data，此时 ctx.PostValue 仍然可用（取普通字段），但文件必须单独处理：
-
f, fh, err := ctx.FormFile("avatar")——f是io.ReadCloser，fh含原始文件名、大小等元信息 - 别忘了
defer f.Close()，否则句柄泄漏 - 如果同时有多个同名文件（
multiple），得用ctx.MultipartForm()拿整个 map，再遍历form.File["avatar"] - 上传大文件前建议加
ctx.Request().MultipartReader()配合限速或临时存储控制，Iris 默认不限制上传大小（依赖 Go 标准库的MaxMemory，默认 32MB）
CSRF 和空值校验不是框架自动做的
Iris 不内置 CSRF token 验证，也不对 PostValue 返回的空字符串做业务层拦截。这意味着：
- 你得自己在模板里塞
<input type="hidden" name="csrf_token" value="{{.CSRFToken}}">，并在 handler 里比对 -
ctx.PostValue("phone") == ""可能是用户没填，也可能是字段名写错——建议配合ctx.IsPost+ 显式检查关键字段非空 - 前端发空字符串
""和字段压根没传，在 Iris 里都表现为PostValue返回""，无法区分；如需严格语义，改用 JSON 提交并定义 required 字段
真正容易被忽略的是：表单编码类型不匹配时，PostValue 会静默返回空，连 error 都不抛——务必确认前端 Content-Type 是 application/x-www-form-urlencoded 或 multipart/form-data，而不是 application/json。
