Iris中表单提交收不到数据，主因是未启用对应解析器：JSON需注册iris.JSONDecoder，表单需iris.FormDecoder；参数绑定依赖导出字段及正确json/form标签；路径须显式注册，不可依赖默认推导。
表单提交时收不到数据？检查解析器是否启用
Iris 默认不自动解析请求体，Content-Type 匹配失败是 90% 的“收不到数据”原因。前端发 application/json，后端没开 JSON 解析器，参数就永远是零值。
- JSON 提交：必须在启动时调用
app.Use(iris.Compression)；app.Use(iris.JSONDecoder)（或确保iris.Default已包含）；控制器方法参数用结构体（如user User），Iris 才会调用ctx.ReadJSON - 表单提交（
application/x-www-form-urlencoded）：需显式启用表单解析器：app.Use(iris.FormDecoder)；否则ctx.PostValue("name")返回空，结构体绑定也失效 - 混合场景（如带文件的表单）：不能只靠
FormDecoder，得用ctx.ReadForm(&v)或ctx.UploadForm手动处理
控制器里怎么写接收逻辑？别依赖自动绑定
Iris MVC 不像 Spring 那样靠注解或命名自动映射字段，它严格按参数类型和标签匹配。写错一个 tag 或漏一个 json 字段，整个结构体就 bind 不上。
- 用结构体接收时，字段必须导出（首字母大写），且加
jsontag：type User struct { Name string `json:"name"` Email string `json:"email"` } - 表单字段名要和结构体字段的
formtag 一致（默认用字段名小写）：Email string `form:"email"`；若前端发的是user_email，就得写`form:"user_email"` - 不要把
iris.Context和结构体混在同一个方法签名里——Iris 会优先尝试用 context 做第一个参数，导致结构体被跳过。正确写法是：func(c *UserController) Create(ctx iris.Context, user User)，不是func(c *UserController) Create(user User, ctx iris.Context)
为什么 POST /users 总是 404？路径注册必须手动
Iris MVC 不推导子路径，Post() 方法只响应根路径（如 /），不是 /users。你写的 Post() 永远不会被调到，除非显式注册。
- 想让
Post()处理POST /users，得在控制器里加BeforeActivation：func(c *UserController) BeforeActivation(b mvc.BeforeActivation) { b.Handle("POST", "/", "Post") } - 想处理
POST /users/{id:long}，必须单独注册：b.Handle("POST", "/{id:long}", "PostWithID")，并定义对应方法：func(c *UserController) PostWithID(id int64, user User) - 路径参数类型必须写对：
{id:long}→int64，{name:string}→string；写成{id}会导致id永远是0
校验失败怎么返回错误？别直接 return ctx.JSON()
直接调 ctx.JSON() 会绕过 Iris 的返回值序列化流程，中间件、错误恢复、日志都失效，且状态码仍是 200。
- 推荐方式：先设状态码，再 return 数据（会被框架自动 JSON 化）：
ctx.StatusCode(iris.StatusBadRequest); return BizError{Code: 40001, Msg: "邮箱格式错误"} - 如果用了统一错误处理器（recover + panic），业务校验失败应主动
panic(&BizError{...})，而不是 return error —— 因为 Iris MVC 完全忽略 controller 方法返回的error - 注意：所有手动设置状态码的分支，都要跟
return，否则后续逻辑仍会执行（Iris 不自动中断方法流）
