ctx.Params不能直接校验因仅为原始字符串映射，无类型/范围/必填语义；需手动转换并检查，而query和JSON参数可通过结构体+validate标签实现自动校验。
为什么 ctx.Params 不能直接做参数校验
因为 ctx.Params 只是 URL 路径段的原始字符串映射（比如 /user/123 中的 "123"），它不包含类型、范围、必填等语义信息，也不触发任何验证逻辑。直接用 strconv.Atoi(ctx.Params().Get("id")) 会把校验和转换混在一起，出错时难以区分是格式错误、越界还是缺失。
Iris 原生不内置参数 schema 校验，得靠中间件或手动结合结构体 + validator 库来补足。
用 context.ReadQuery + 结构体标签做查询参数校验
适合 GET /search?name=foo&age=25 这类场景。核心是定义带 validate 标签的结构体，再调用 ctx.ReadQuery 自动绑定并校验：
type SearchInput struct {
Name string `url:"name" validate:"required,min=2,max=20"`
Age int `url:"age" validate:"min=0,max=150"`
}
ctx.ReadQuery(&input) 会返回 error，如果校验失败，err.Error() 类似 "Key: 'SearchInput.Age' Error:Field validation for 'Age' failed on the 'min' tag" —— 可据此统一返回 400。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 必须显式指定
url:标签，否则字段无法从 query string 映射 -
validate标签语法和go-playground/validator一致，支持嵌套、自定义函数 - 注意：空字符串对
int字段默认转成0，若要区分“未传”和“传了 0”，字段类型得用*int
路径参数（ctx.Params）校验必须手动转换 + 检查
像 GET /user/{id:int} 这种带类型约束的路由写法，Iris 仅做基础类型转换（如 "123" → 123），但不会检查 id > 0 或是否在数据库存在。真正校验还得自己来：
app.Get("/user/{id:int}", func(ctx iris.Context) {
id := ctx.Params().GetIntDefault("id", -1)
if id <= 0 {
ctx.StatusCode(iris.StatusBadRequest)
ctx.WriteString("id must be positive")
return
}
// 继续业务逻辑...
})
-
{id:int}路由约束只影响匹配——不满足的请求根本进不到 handler，但不保证值合理 - 用
GetIntDefault比GetInt更安全，避免 panic；但默认值需谨慎选（比如 -1 可能是合法业务 ID） - 如果校验逻辑复杂（如查 DB 判断是否存在），建议抽成独立函数，别堆在 handler 里
POST JSON 参数用 ctx.ReadJSON + 结构体校验最稳
这是最常用也最推荐的方式。Iris 的 ReadJSON 会自动调用 json.Unmarshal 并支持 validate 标签：
type CreateUserInput struct {
Username string `json:"username" validate:"required,alphanum,min=3,max=16"`
Email string `json:"email" validate:"required,email"`
}
handler 中：if err := ctx.ReadJSON(&input); err != nil { ... }。错误类型通常是 *json.UnmarshalTypeError 或 validator.ValidationErrors。
- JSON 字段名必须和
json:标签一致，否则绑定失败且无提示 - 如果允许部分字段为空，对应 struct 字段类型用指针（
*string）或加omitempty标签，但validate不会跳过空值 —— 需用omitempty,required组合控制 - Iris 默认不限制 JSON body 大小，大文件上传需提前用
ctx.ReadLimit设限，否则可能 OOM
路径参数没 schema、query 和 JSON 才有结构化校验能力，这点容易忽略。别指望 {id:uint64} 能防住负数或超大值，该手动判的还得判。
