iris 中 put/delete 路由必须显式调用 app.put() 或 app.delete() 注册，不依赖方法名前缀；路径参数须用 ctx.params().get() 获取，非 ctx.urlparam()；读请求体必须在写响应前完成，否则失败。
PUT/DELETE 路由必须显式注册，不能靠方法名自动推断
很多人写 DeleteAvatar 这样的控制器方法，以为 Iris 会自动绑定到 DELETE /user/avatar，结果请求 404。Iris 不做方法名→HTTP动词的映射，Delete 开头只是命名习惯，真正起作用的是 app.Delete() 这类显式注册调用。
常见错误现象：curl -X DELETE http://localhost:8080/user/avatar 返回 404，但 app.Get("/user/avatar", ...) 能正常响应；或者控制器方法执行了，但 HTTP 状态码是 200 而不是预期的 204/200。
- 必须用
app.Put("/path", handler)或app.Delete("/path", handler)显式注册 - 路径需完全匹配：如果路由是
/user/{id:uint64}，DELETE 请求必须带 ID，如DELETE /user/123 - 别依赖 “方法名以 Delete 开头就自动生效” —— 这在 Iris 中不存在
参数提取：路径参数用 ctx.Params().Get()，别用 ctx.URLParam()
PUT/DELETE 通常带路径参数（如 /posts/42），但新手常误用 ctx.URLParam("id") 去取，结果始终为空字符串。
使用场景：处理 PUT /api/users/{id:uint64}，想拿到 42 更新对应用户。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 正确方式：
id := ctx.Params().Get("id")或带类型转换的ctx.Params().GetUint64("id") -
ctx.URLParam("id")只读?id=42这种查询参数，对路径段无效 - 若参数名不一致（比如路由定义
{userID}，却调用ctx.Params().Get("id")），返回空字符串且不 panic —— 容易漏掉校验，建议加if id == ""判断
请求体读取顺序很重要：先读 ctx.Request().Body，再写响应
PUT/DELETE 处理中常需解析 JSON body（如更新用户资料），但若在 ctx.JSON() 或 ctx.StatusCode() 之后才调用 ctx.ReadJSON()，会读不到数据或 panic。
原因：HTTP 协议限制，响应一旦写出（尤其当底层 flush 了），部分客户端/中间件会关闭连接或丢弃后续读操作；Iris 的 Context 也明确要求「读请求体必须在写响应之前」。
- 正确顺序：先
err := ctx.ReadJSON(&payload)，再处理逻辑，最后ctx.JSON(...) - 别在中间件里提前写响应（如鉴权失败时
ctx.JSON(401, ...)）后还调用ctx.Next()—— 后续 handler 仍可能尝试读 body，导致不可预期行为 - 对大体积 PUT 请求，注意
ctx.ReadBody()默认有 32MB 限制，超限会返回413 Payload Too Large，可调app.ConfigureHost(iris.WithRequestBodyLimit(100
调试 405 Method Not Allowed 的真实原因
发 PUT/DELETE 请求得到 405，不代表路由没注册，而是该路径上没注册对应 method 的 handler，或者被中间件拦截了。
典型场景：只注册了 app.Get("/user") 和 app.Post("/user")，但没写 app.Put("/user")，此时 PUT /user 就会 405；又或者用了 app.Any("/user", ...)，但 handler 里没判断 ctx.Method()，直接返回了 GET 的逻辑。
- 检查是否漏注册：运行时加日志
app.Logger().Infof("Registered routes: %+v", app.GetRoutes())，确认PUT和DELETE条目存在 - 确认没有其他中间件调用
ctx.StopExecution()且未覆盖所有分支 - 浏览器表单默认只支持 GET/POST，测试 PUT/DELETE 务必用
curl或 Postman，避免被前端限制误导
UpdateUser 的函数毫无意义，除非你亲手把它塞进 app.Put() 的第三个参数里 —— 没有魔法，只有显式。
