自己写框架是为了在关键路径上拿回控制权,如定制路由匹配、中间件顺序、Context 与 trace ID 绑定;必须用 radix 树实现路由、洋葱模型管理中间件、sync.Pool 复用 Context、严格分层隔离。

自己写框架不是为了造轮子,而是为了在关键路径上拿回控制权——比如你要改路由匹配逻辑、定制中间件执行顺序、或者把 Context 和业务 trace ID 绑死。标准库够用时别动,但一旦遇到 gin.Context 无法透传 gRPC metadata、或 http.Handler 链里没法插熔断器,就得从底层设计开始。
路由必须用 radix 树,别碰 map[string]HandlerFunc
用 map 存路由看似简单,但一碰到 /user/:id、/user/:id/orders、/users/search 这类混合路径,就会卡在字符串前缀判断和参数提取上,性能随路由数线性下降。radix 树(压缩前缀树)才是 Web 框架路由的标配。
- 每个节点只存公共前缀,分支按路径段(如
"user"、":id")分叉,不浪费内存 - 匹配时逐段比对,时间复杂度是 O(路径段数),和总路由数无关
- 动态参数(
:id)和通配符(*filepath)要单独标记节点字段,不能靠正则回溯 - Gin 的
engine.trees就是按 HTTP 方法分 7 个 radix 树,GET/POST 各自独立查找,避免锁竞争
中间件链必须支持洋葱模型,且禁止递归调用
所谓“洋葱模型”,是指中间件能包裹 handler,在进入时做前置(如鉴权)、在 c.Next() 后做后置(如日志)。但实现上绝不能用递归嵌套 mw1(mw2(mw3(h))),否则调试时栈深不可控,也无法动态增删中间件。
- 正确做法是把中间件存成
[]func(*Context)切片,用index字段控制执行位置(Gin 就是这么干的) - 每个中间件内必须且只能调一次
c.Next();漏调,后续全跳过;多调,index越界 panic -
c.Abort()实质是把index设为切片长度,让后续c.Next()直接退出循环 - 如果你要兼容原生
http.Handler,中间件类型得定义为func(http.Handler) http.Handler,而不是func(http.HandlerFunc) http.HandlerFunc,后者无法传入带状态的 logger 或 config 实例
Context 对象必须复用,不能每次请求 new 一个
高并发下每秒几千请求,如果每个都 &Context{...},GC 压力会直接拉满。Gin 用 sync.Pool 管理 *Context 实例,这是必须抄的点。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
Context里不能放大对象(如*sql.DB、map[string]interface{}),只存指针或小结构体 -
Keys字段用map[string]any是为了方便中间件传值,但要注意 key 冲突——建议用私有类型做 key:type userIDKey struct{},而非字符串"user_id" - 不要在
Context里塞 request body 解析结果(如json.RawMessage),应该由 handler 自己解析并校验,避免中间件越权 - 如果要透传 tracing context,别用
context.WithValue(r.Context(), ...)套娃,直接在Context字段里加TraceID string字段,更轻、更快、更可控
分层边界必须在项目初始化时就钉死
Go 没有框架强制约束,handler 层一旦开始写 db.QueryRow 或调 http.Post,两周后你就得重写整个服务。分层不是风格问题,是能否活过三个月的底线。
-
handler只做三件事:解析请求(c.ShouldBindJSON)、调service方法、封装响应(c.JSON) -
service层禁止 importdatabase/sql、net/http、github.com/gin-gonic/gin—— 它只依赖repo接口和 domain struct -
repo接口定义要抽象动作,不是数据库操作:比如FindOne(ctx, filter map[string]interface{}) (*User, error),而不是GetByID(id int) (*UserModel, error),前者能适配 MySQL/MongoDB/Redis - 三层数据结构隔离:handler 用
UserRequest,service 用User(无 DB 字段),repo 用UserModel(含ID、CreatedAt);转换只在层边界发生一次
最易被忽略的是中间件和 Context 的耦合深度——很多人以为只要写了 func(c *gin.Context) 就算中间件,但没意识到 c.Request.Context() 和 c 自身生命周期并不等价,跨 goroutine 传递时容易丢 trace 或 timeout。真正在生产环境扛住万级并发的框架,从来不是靠功能多,而是每一层都清楚自己该 hold 住什么、不该碰什么。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










