iris中需手动校验请求体：定义带validate tag的结构体，用ctx.readbody()绑定后逐字段验证；推荐用中间件统一拦截非法参数并调ctx.stopexecution()终止执行；路径参数可用路由约束校验，查询参数需手动取值判断；注意content-type匹配、字段tag命名及body大小限制。
怎么在 Iris 中做请求体结构校验（JSON / 表单）
Iris 本身不自动校验请求体字段，必须手动解析 + 验证。别指望 ctx.ReadBody() 或 ctx.FormValue() 返回值天然合法——它们只负责读取，不校验格式、范围或必填性。
推荐做法是：先定义结构体并加 struct tag，再用 ctx.ReadBody() 绑定，最后对结构体字段逐个判断。例如用户注册：
type RegisterReq struct {
Username string `json:"username" validate:"required,min=4,max=16"`
Password string `json:"password" validate:"required,min=8"`
Email string `json:"email" validate:"required,email"`
}
func registerHandler(ctx iris.Context) {
var req RegisterReq
if err := ctx.ReadBody(&req); err != nil {
ctx.StatusCode(400)
ctx.JSON(map[string]string{"error": "invalid request body"})
return
}
// 手动校验 email 格式（struct tag 不自动触发）
if !validator.IsEmail(req.Email) {
ctx.StatusCode(400)
ctx.JSON(map[string]string{"error": "invalid email"})
return
}
// …继续业务逻辑
}
- 别依赖第三方 validator 包的自动调用——Iris 不集成它，
validate:tag 只是标记，不会自动生效 -
ctx.ReadBody()对 JSON 和表单都可用，但注意：若同时支持两种 Content-Type，需提前统一约定（比如只接受application/json），否则 URL 解码时机不一致会导致校验结果错乱 - 如果字段有嵌套或动态 key（如 map[string]interface{}），
ReadBody()无法做类型安全校验，得转成map[string]interface{}后手动遍历检查
怎么拦截非法参数并提前返回错误（避免进 controller）
把校验逻辑塞进每个 handler 里，既重复又易漏。正确方式是用中间件，在路由匹配后、handler 执行前拦截并终止非法请求。
示例中间件：
func validateMiddleware(next iris.Handler) iris.Handler {
return func(ctx iris.Context) {
path := ctx.Path()
method := ctx.Method()
// 排除免校验路径
if path == "/health" || (method == "GET" && strings.HasPrefix(path, "/api/v1/public/")) {
next(ctx)
return
}
// 只对 POST/PUT 做体校验
if method == "POST" || method == "PUT" {
if err := validateRequestBody(ctx); err != nil {
ctx.StatusCode(400)
ctx.JSON(map[string]string{"error": err.Error()})
ctx.StopExecution() // 必须调，否则 next() 还会执行
return
}
}
next(ctx)
}
}
- 中间件里调
ctx.StopExecution()后，绝不能跟ctx.Next()或next(ctx)——这会 panic - 别在中间件里用
ctx.GetBody()读原始 body，它可能已被其他中间件消费（如日志中间件），应直接用io.ReadAll(ctx.Request().Body)+io.NopCloser重置 - 若项目用 MVC 模式，
Controller的BeginRequest()方法也可做预校验，但它晚于中间件，且无法阻止后续 action 执行，优先选中间件
怎么处理 URL 路径参数和查询参数校验
路径参数（如 /user/{id:int}）和查询参数（?page=2&size=10）的校验，Iris 提供了基础类型约束和自定义验证器，但仅限「格式」层面，不覆盖业务规则（如 id 是否真实存在）。
路径参数校验示例：
app.Get("/user/{id:int min(1) max(999999)}", func(ctx iris.Context) {
id := ctx.Params().GetIntDefault("id", 0)
// 此时 id 已保证是 1~999999 的整数
})
-
min()/max()等内置验证器只在路由匹配阶段起作用；匹配失败直接 404，不进 handler - 查询参数没内置验证器，得手动取：
page := ctx.URLParamIntDefault("page", 1)，然后自己判断是否越界 - 别在路由里写
{id:string regexp(^[a-z0-9]{8}$)}这种复杂正则——可读性差，出错难调试；建议放 handler 里用regexp.MatchString()显式校验
为什么前端传的字段后端收不到或值为空
常见原因不是代码写错，而是 HTTP 协议层或 Iris 内部机制导致的「隐式丢弃」。
- Content-Type 不匹配：
application/json请求体却用ctx.FormValue()读——永远为空；反之亦然 - 字段名大小写不一致：JSON key 是
userName，结构体字段是Username但没写json:"userName"tag，绑定失败后字段保持零值 - 请求体超长被截断：Iris 默认限制 body 大小为 32MB，若上传大文件或超长文本，需提前调
app.Adapt(iris.WithPostMaxMemory(100 - 前端发了空字符串
""，后端结构体字段是string类型，它合法但业务上可能不允许——这种得靠手动判空，不是框架能代劳的
最麻烦的是 multipart 表单混 JSON 字段：Iris 的 ctx.ReadForm() 和 ctx.ReadBody() 互斥，同一请求只能选一种方式读，否则第二次读会返回空或 error。
