iris.Router().Handle() 是统一多方法注册入口,需显式传入大写字符串切片(如 []string{"GET", "PUT"}),不自动 fallback;Any() 固定包含 HEAD 且等价于七种标准方法;Methods() 提供类型安全的可复用方法集;OPTIONS 必须显式注册以支持跨域预检。

iris.Router().Handle() 支持多方法注册但需手动传数组
iris 不像某些框架(如 Gin)提供 GET、POST 等独立快捷方法直接组合,它的 Handle() 是底层统一入口,必须显式传入方法字符串切片。比如想让一个路由同时响应 GET 和 PUT,不能只写一次 Get() 或 Put(),得用 Handle() 并传 []string{"GET", "PUT"}。
常见错误是误以为 router.Get("/api", handler) 后再调 router.Put("/api", handler) 就算“匹配多个方法”——其实这是两个独立路由,虽然路径相同,但 iris 会分别注册,且无法共享中间件或统一管理生命周期。
- 正确写法:
router.Handle([]string{"GET", "PUT"}, "/api", handler) - 支持全部标准方法:包括
"HEAD"、"OPTIONS"、"PATCH"、"DELETE",大小写敏感,必须全大写 - 如果漏掉
HEAD,即使注册了GET,浏览器预检或某些客户端发起的HEAD请求也会 404(iris 不自动 fallback)
iris.Any() 是最简方式但隐含 HEAD 自动注册
Any() 看似只是“匹配任意方法”,实际行为更具体:它等价于 Handle([]string{"GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"}, path, handler)。注意,它**固定包含 HEAD**,哪怕你业务逻辑里没显式处理 HEAD,iris 也会把请求转发过去——这意味着 handler 必须能安全响应 HEAD(比如不写 body、只设 header)。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 适合调试或原型阶段快速暴露接口:
router.Any("/debug", debugHandler) - 生产环境慎用:暴露过多方法可能违反 REST 约束,也增加被探测/滥用风险
- 它不会注册
CONNECT或TRACE,这两个方法 iris 默认不支持,强行注册会 panic
用 iris.Methods() 构造可复用的方法集
当多个路由需要相同方法组合(例如所有资源 API 都要 GET/POST/PUT),硬编码字符串切片易出错且难维护。iris 提供 iris.Methods() 工具函数,返回 []string,可提前定义并复用:
const resourceMethods = iris.Methods(iris.MethodGet, iris.MethodPost, iris.MethodPut) router.Handle(resourceMethods, "/users", userHandler) router.Handle(resourceMethods, "/posts", postHandler)
这样比手写 []string{"GET","POST","PUT"} 更安全——拼写错误会在编译期报错(iris.MethodGet 是 const),而不是运行时报 405。
-
iris.MethodGet等常量定义在github.com/kataras/iris/v12包中,无需额外 import - 不支持自定义方法名(如
"SEARCH"),非标准方法必须手写字符串并确保服务器配置允许 - 注意:该函数只是语法糖,不改变路由匹配性能,底层仍是切片遍历
OPTIONS 预检请求需显式处理跨域场景
前端发跨域请求时,浏览器会先发 OPTIONS 预检。如果你只注册了 GET 和 POST,但没包含 OPTIONS,预检就会失败,后续请求根本发不出。iris 不会自动响应 OPTIONS,必须手动覆盖。
- 推荐做法:对需要跨域的路径,用
Handle()显式加入"OPTIONS",并在 handler 中设置 CORS 头:w.Header().Set("Access-Control-Allow-Methods", "GET,POST,PUT") - 不要依赖全局中间件拦截
OPTIONS:iris 的中间件执行顺序和路由匹配耦合,未匹配到路由时中间件不触发 - 若用第三方 CORS 中间件(如
iris-contrib/middleware/cors),仍需确保路由本身注册了OPTIONS方法,否则中间件收不到请求
HEAD 和 OPTIONS 的隐式需求——它们不携带 body,但必须返回正确状态码和 header,否则前端拿不到元数据或跨域失败。


















