iris 不支持表单到结构体自动绑定，应优先用 ctx.postvalue 系列方法；formvalue 因懒解析可能静默失败，postvalue 更可靠；postvaluetrim 自动去首尾空格，postvalueint/default 安全转数字，文件需用 formfile 且须判空。
直接用 ctx.PostValue 系列方法，别调 ctx.FormValue，也别指望结构体自动绑定 —— Iris 不支持表单到结构体的直绑。
为什么 ctx.FormValue("xxx") 有时返回空？
因为 FormValue 会同时查 URL 查询参数和 POST 表单，但它的底层依赖 ParseMultipartForm 或 ParseForm 是否已执行。Iris 默认不自动解析表单体，首次调用 FormValue 会尝试懒解析，但遇到边界情况（比如 multipart 中混了文件+文本、或 Content-Type 不规范）就静默失败，返回空字符串。
- 只传纯文本表单（
application/x-www-form-urlencoded）时，PostValue更可靠 —— 它强制走ParseForm流程 - 如果请求里同时带文件上传（
multipart/form-data），PostValue仍能取到文本字段，但FormValue可能因 multipart 解析失败而全盘失效 - 永远不要在没检查
ctx.FormFile("avatar") != nil的前提下直接调.Open()，否则 panic
PostValue 和 PostValueTrim 怎么选？
用户输入常带首尾空格，比如用户名填了 “ admin ”，直接校验长度或比对会出错。用 PostValueTrim 能省掉 strings.TrimSpace 这一步，且无性能损耗。
-
PostValue("username")→ 返回原始字符串，含空格 -
PostValueTrim("username")→ 自动去首尾空格，适合登录、注册等场景 -
PostValueDefault("page", "1")→ 字段缺失时给默认值，避免空指针或逻辑分支爆炸
数字字段怎么安全转 int？
手写 strconv.Atoi(ctx.PostValue("age")) 非常危险：用户输 “25abc” 或留空，就会 panic。Iris 提供了带容错的封装，直接用 PostValueInt 或 PostValueIntDefault。
-
PostValueInt("age")→ 返回(int, error)，出错时error != nil，int值为-1 -
PostValueIntDefault("age", 18)→ 出错或为空时直接返回18，适合年龄、分页 size 等有合理默认值的字段 - 注意：
PostValueInt64对应int64，别和PostValueInt混用，ID 类字段建议优先用PostValueInt64
表单里有文件，文本字段还能用 PostValue 吗？
可以，但必须确保你没先调 ctx.FormValue 或其他触发 multipart 解析失败的操作。Iris 的 PostValue 在 multipart 场景下会跳过 ParseMultipartForm，改用更轻量的解析路径取文本字段。
- 文件字段必须用
ctx.FormFile("avatar")获取，它返回*multipart.FileHeader - 获取后务必检查是否为
nil：iff, err := ctx.FormFile("avatar"); err == nil && f != nil { ... } - 文本字段和文件字段可并存，互不影响，前提是别用
ctx.ReadForm—— 它是全局解析，会干扰后续单独取字段的逻辑
最易被忽略的一点：Iris 默认不解析任何请求体，所有表单读取都依赖你主动调用对应方法。没有“自动绑定”这回事，也没有中间件帮你兜底 —— 错过一次 PostValue 调用，参数就永远拿不到。
