post路由必须用app.post或router.post，因其内置参数绑定、content-type识别和错误拦截；混用app.handle("post",...)会跳过这些导致readjson()或formvalue()失效。
POST路由注册必须用 app.Post 或 router.Post，不能混用 app.Handle("POST", ...)
虽然 app.Handle 理论上支持任意 method，但 Iris 的 app.Post 内部做了参数绑定、Content-Type 自动识别（如 application/json、application/x-www-form-urlencoded）和错误提前拦截。直接用 app.Handle("POST", ...) 会跳过这些逻辑，导致 c.ReadJSON() 或 c.FormValue() 返回空或 panic。
常见错误现象：
- 前端发 JSON，后端
c.ReadJSON(&v)返回EOF或 nil 值 - 表单提交后
c.FormValue("name")始终为空，但c.PostValue("name")可取到——说明没走标准 form 解析流程
正确写法只有一条路径：app.Post("/login", loginHandler)，且 handler 必须接收 iris.Context 类型参数。
表单 vs JSON 请求，参数读取方式完全不同
Iris 不会自动判断你传的是 form 还是 JSON；它只按请求头 Content-Type 和你调用的读取方法匹配。一旦错配，就拿不到数据。
使用场景与对应方法：
-
Content-Type: application/x-www-form-urlencoded或multipart/form-data→ 用c.FormValue("field")或c.PostValue("field") -
Content-Type: application/json→ 必须用c.ReadJSON(&struct{})，且 struct 字段需有 JSON tag（如Name string `json:"name"`） - 混合场景（比如 JSON body + query 参数）→
c.URLParam("id")读 query，c.ReadJSON()读 body
容易踩的坑：
- 前端发 JSON，后端却调用
c.FormValue()→ 永远为空 - 前端用
fetch(..., {body: new FormData(...)})，后端用ReadJSON()→ 解析失败 - 结构体字段没加
json:tag，但前端 key 是小写（如{"user_name": "a"}），导致字段不赋值
app.Post 路由里的中间件执行顺序影响参数可读性
如果你在 POST 路由前挂了自定义中间件（比如日志、鉴权），而该中间件调用了 c.Request().Body 但没还原，后续 c.ReadJSON() 就会读到空流 —— 因为 HTTP Body 只能读一次。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
解决方案：
- 中间件中不要直接读
c.Request().Body，改用c.Request().GetBody()（返回可重复读的函数） - 若必须解析 body（如做签名验证），解析完后调用
c.Request().Body = io.NopCloser(bytes.NewReader(data))还原 - 优先用 Iris 内置中间件（如
iris.Recover、iris.Logger），它们已处理好 Body 复用逻辑
性能影响：每次 ReadJSON() 都会完整解码字节流，大 payload 下注意内存占用；必要时可先用 c.ContentLength() 做大小校验再读。
动态路径 + POST 怎么写？参数位置很关键
Iris 的 POST 路由支持路径参数（如 /api/v1/users/{id:uint64}），但注意：路径参数只能从 URL 提取，POST body 里的同名字段不会覆盖它。
示例：
app.Post("/api/v1/users/{id:uint64}", func(c iris.Context) {
id := c.Params().GetUint64Default("id", 0) // 从 /api/v1/users/123 中取
var req struct {
Name string `json:"name"`
Age int `json:"age"`
}
c.ReadJSON(&req) // 从 body 中取
c.JSON(map[string]interface{}{"path_id": id, "body_name": req.Name})
})
容易被忽略的点：
-
{id:uint64}中的类型约束（如uint64）只校验路径值，不校验 body；body 里传字符串"id": "abc"不会报错，只是 struct 字段为零值 - 路径参数名（
id）和 JSON 字段名（id）完全独立，别指望自动合并 - 如果路径带可选参数（如
/users/{id:uint64}/{action:string}），两个都得用c.Params().Get()显式取，Iris 不会自动注入到 handler 参数
复杂点在于：当你要同时支持 POST /users（创建）和 POST /users/{id}（更新）时，必须拆成两个路由，Iris 不支持 method + path pattern 的模糊匹配降级。
