Iris中PUT路由必须显式注册为app.PUT("/path/:param", handler),路径参数用冒号语法,需配合ctx.Params().Get()提取;必须单独注册OPTIONS预检路由或在中间件中拦截并调用ctx.StopExecution(),且JSON解析须用ctx.ReadJSON并校验错误。

PUT 请求在 Iris 中必须显式注册,不能靠“自动映射”或混用 Patch;它语义上代表“全量替换”,路径参数和请求体解析方式也和 Get 或 Post 不同。
怎么注册 PUT 路由才不会 404
Iris 不提供资源路由自动绑定,app.Resource 不存在,写 app.PUT("/users/:id", handler) 是唯一正解。常见错误是误用 app.Handle("PUT", ...) —— 它绕过方法校验,导致 OPTIONS 预检失败,跨域更新直接卡住。
- 路径中参数必须写成
:id(不是{id}或),且大小写敏感 - 若路径含多级参数,如
/users/:uid/orders/:oid,需按顺序调用ctx.Param("uid")和ctx.Param("oid") - 别在同一个路径上同时注册
PUT和Patch,Iris 不报错,但前端无法区分语义,后期维护成本陡增
怎么安全读取 PUT 请求的 JSON 数据
ctx.ReadJSON 是标准做法,但容易踩两个坑:一是误用 ctx.FormValue(只对 application/x-www-form-urlencoded 有效),二是没做结构体字段校验就直接入库。
- 定义结构体时,JSON tag 必须显式声明,例如
Username string `json:"username" validate:"required"` - 调用
ctx.ReadJSON(&v)后,务必检查 error,空指针或类型不匹配会导致 panic - 如果前端发的是
application/json但 body 为空,ReadJSON会返回io.EOF,不是业务逻辑错误,需单独判断 - 不要用
ctx.PostValue或ctx.URLParam尝试读 JSON 字段,它们根本不会生效
为什么 PUT 接口常被 CORS 拦截
浏览器发起 PUT 前必先发 OPTIONS 预检,而 Iris 默认不自动响应 OPTIONS,除非你显式注册或中间件拦截。
- 最稳方案:加一行
app.Options("/users/:id", func(ctx iris.Context) { ctx.StatusCode(204) }) - 若用中间件统一处理预检,开头必须加
if ctx.Method() == "OPTIONS" { ctx.StatusCode(204); ctx.StopExecution(); return } - 漏掉
ctx.StopExecution()会导致请求继续往下走,进到你的 handler,然后因 body 已被读取而 panic - 别依赖
app.Use全局注册的中间件来兜底——它可能在预检阶段就读了 body,后续 handler 就拿不到原始数据
真正难的不是写完 app.PUT,而是确认前端发的是全量数据、服务端校验了字段、数据库执行了原子更新、并且整个链路在跨域下稳定跑通——这四步里任何一环断开,PUT 就只是个 400 或静默失败的摆设。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











