Gin

Gin 是一个围绕 net/http 构建的高性能 Web 框架。本册不按 API 罗列功能，而是沿着路由注册、请求分派、Context 生命周期和输入绑定四条链路读源码。

本册问题地图

Gin 把一次 HTTP 请求压缩成“路由匹配 + Context 状态 + handler chain”三段短路径。本册回答：

1. 路由注册后保存在哪里？ 每种 HTTP 方法维护一棵压缩 Radix tree，静态段、参数段与 catch-all 有明确优先级。
2. 请求命中路由后如何执行多个 handler？ handler 被合并成扁平 chain，Context.index 控制前进、回退与中止。
3. 为什么能复用 Context？ 请求开始前 reset，结束后放回 sync.Pool；跨 goroutine 必须复制所需状态。
4. 请求数据怎样进入结构体？ Binding 根据方法和 Content-Type 选择解码器，再交给 validator；body 的一次性读取决定了缓存边界。
5. 为什么 Abort 之后代码还可能继续执行？ Abort 只阻止后续 handler，不会自动 return 当前函数，也不会撤销已经写出的响应。

读完整册后，应当能从 ServeHTTP 追到树匹配、参数写入、middleware 执行和响应提交，并能解释 404、重定向、绑定失败和异步处理各自在哪一层发生。

版本快照

项	值
仓库	gin-gonic/gin
本地路径	E:\source\go\gin
分支	master
Commit	34dac20（2026-06-27）
最近 tag	v1.12.0

本册坐标均基于该 commit；上游演进后行号可能漂移。

它解决什么问题

• 把 net/http 的 Handler 接口扩展为可组合的路由、中间件和请求上下文。
• 用压缩 Radix tree 降低大量路径匹配的比较成本，同时支持参数和 catch-all 路由。
• 用 sync.Pool 复用请求级 Context，减少高并发下的短生命周期分配。
• 把 JSON、表单、Query、Header、URI 和校验统一成可替换的 binding 接口。

模块地图

模块	职责	入口
gin.go	Engine、HTTP 入口、方法树分派	Engine.ServeHTTP
routergroup.go	路由分组、前缀和 handlers 合并	RouterGroup.handle
tree.go	压缩 Radix tree、参数提取、重定向建议	node.getValue
context.go	请求状态、链执行、响应和绑定	Context
binding/	解码器、字段映射和 validator	binding.Binding

读码入口顺序

1. gin.New 创建 Engine，并把 pool.New 指向 allocateContext。
2. RouterGroup.handle 通过 combineHandlers 合并分组 middleware 与终端 handler。
3. Engine.addRoute 将方法和路径写入对应 Radix tree。
4. Engine.ServeHTTP 从池中取 Context，handleHTTPRequest 匹配并调用 Context.Next。
5. 最后阅读 Context.Copy、ShouldBind 和 binding.defaultValidator，理解异步与输入边界。

本册目录

• 整体架构：Engine、RouterGroup、tree、Context 的关系与两条主流程
• Radix 树路由匹配：压缩边、优先级、参数和 catch-all
• Context 复用与 sync.Pool：请求状态重置、池化和异步复制
• 中间件与 Abort：扁平 handlers chain 与洋葱模型
• 参数绑定与校验：自动选择、Body 重放和 validator
• 面试专题：高频题、高难追问和排障题

横向对照

对象	对照点
net/http.ServeMux	Gin 增加参数路由、分组、中间件和 Context
XXL-JOB	都把请求/任务流程拆成可组合链路，但 Gin 是进程内同步 HTTP 链
Netty	都强调复用和低分配；Gin 复用 Context，Netty 复用 ByteBuf

Related

• Go 源码解析
• XXL-JOB 源码解析