FormValue同时读URL查询参数和请求体数据，需先解析请求体；PostValue仅从POST/PUT/PATCH请求体解析表单数据，不读URL参数，避免因URL带参导致取值错乱。
FormValue 和 PostValue 的区别必须分清
很多人一上来就用 FormValue 接所有字段，结果在 POST 表单里取不到值——因为 FormValue 同时读 URL 查询参数（?key=value）和请求体里的表单数据，但前提是请求体已被解析。而 PostValue 只从 POST/PUT/PATCH 请求体中解析 application/x-www-form-urlencoded 或 multipart/form-data 数据，不碰 URL 参数。
常见错误现象：FormValue("username") 在纯 POST 提交时返回空，但 URL 带参（如 /login?debug=1）时却意外有值，造成逻辑错乱。
- 只处理表单提交 → 优先用
PostValue或PostValueTrim（自动去首尾空格） - 要兼容 GET 查询 + POST 表单混合场景 → 用
FormValue，但得意识到它“来源不唯一” - 需要整张表单映射 → 调用
FormValues()，注意返回map[string][]string，且必须判空：if vals := ctx.FormValues(); vals != nil { ... }
文件上传和普通字段混在一起时怎么安全取值
当表单含 <input type="file">，Content-Type 变成 multipart/form-data，此时 Iris 默认仍能用 PostValue 取文本字段——但有个关键前提：PostMaxMemory 配置不能太小，否则整个 multipart 解析会失败，导致所有字段都拿不到。
默认内存上限是 32MB，对多数登录/注册表单足够；但若允许上传头像或文档，需显式调大：
app.Run(iris.Addr(":8080"), iris.WithPostMaxMemory(64<<20)) // 64MB
容易踩的坑：
- 没配
WithPostMaxMemory，又传了文件 →PostValue全部返回空，无报错，极难定位 - 用
FormValue取文件字段名 → 返回空字符串（它不解析 multipart 的文本部分） - 未检查
ctx.FormFile("avatar")是否为nil就直接.Open()→ panic
类型转换别硬写 if-else，用内置方法防 panic
用户输个 “123abc” 进数字字段，手写 strconv.Atoi(ctx.PostValue("age")) 会 panic。Iris 提供带容错的封装：
-
PostValueInt("age")→ 返回(int, error)，出错时 error 不为 nil，值为 -1 -
PostValueIntDefault("age", 18)→ 出错或为空时直接给默认值 18 -
PostValueTrim("username")自动去空格，避免 “ admin ” 校验失败
性能影响几乎为零，但省去大量 strings.TrimSpace 和 if err != nil 套壳代码。注意：PostValueInt64 实际解析 float64 字符串（如 “123.0”），不是严格 int64，别用于精确 ID 场景。
验证失败时怎么原样回填表单并提示
Iris 没内置表单重渲染机制，得手动把原始值塞进模板上下文。比如登录失败后，要保留用户名但清空密码框：
ctx.ViewData("Username", ctx.PostValueTrim("username"))
ctx.ViewData("Error", "用户名或密码错误")
ctx.View("/signin.html")
模板里用 {{.Username}} 回填 input 的 value 属性。关键点：
- 密码字段永远不回填（安全底线），模板里 password input 的 value 留空
- 验证码这类一次性字段，验证失败后应刷新 token 并重置前端图像，不能靠回填
- 如果用了
FormValues()批量取值，记得对每个 key 单独 trim 和校验，别假设所有值都非空
最易被忽略的是：表单提交后服务端重定向（302）再渲染，会导致原始 POST 数据丢失——必须用服务端直渲（ctx.View），不能 ctx.Redirect。
