Skip to main content

1 / 4概念

Routing

读完能解释一次请求为什么命中某条路由、绑定失败为什么返回 400 或 415,并在 Gin 与 Echo 之间选对注册方式和绑定 API。路由决定“谁来处理”,绑定决定“输入是什么”;两者的默认行为不同,排障顺序也不同。

1 概念​

1.1 一句话定义​

路由把 HTTP 方法和路径映射到一条 handler 链,绑定把路径参数、查询串、请求体等来源的数据解码进结构体并执行校验。Gin 用内建路由树与 binding 包完成这两步,Echo 用 radix tree 与 Binder、Validator 两个接口;两者的树结构和默认状态码并不相同。

1.2 它解决什么问题​

  • 路径表达能力:原生 http.ServeMux 在 Go 1.22 之前只做前缀匹配,路径参数和通配符要自己解析。
  • 方法分派:同一个资源要按 GET、POST、PUT、DELETE 分开处理,并区分 404 与 405。
  • 输入解码:每个 handler 都重复读取 JSON、转换类型、校验字段,错误格式不统一。
  • 分组与版本:路由前缀、版本号和鉴权中间件应一起挂载。
  • 路由表治理:冲突与重复注册应在启动期暴露,尾斜杠策略应全站统一。

1.3 不属于本页的内容​

主题去哪
中间件顺序、c.Next() 与 next(c)Middleware
http.Server、信号、ShutdownServer Lifecycle
goroutine、channel、context 取消Goroutines and Channels
模块、构建、测试、交叉编译Go Toolchain
HTTP 方法语义、缓存与条件请求Application Protocols

1.4 关键术语​

术语含义容易混淆的点
radix tree按路径前缀压缩的匹配树不是正则匹配
静态段路径中固定不变的片段匹配优先级最高
路径参数:id 形式的占位符不是查询参数
通配符Gin 的 *path,Echo 的 *只能出现在路径末尾
路由组共享前缀和中间件的注册单元不是独立子路由
尾斜杠重定向自动补上或去掉末尾 /Gin 默认开启,Echo 默认不做
404 / 405路径不存在 / 方法不允许Gin 默认不产生 405
绑定把请求数据解码进结构体不负责业务规则
校验按 tag 或 Validator 检查字段只覆盖形状,不覆盖权限
反向路由由路由名生成 URL只有 Echo 内建