Go高性能框架核心是控制四类开销：内存分配、接口断言、goroutine启动、系统调用；标准库net/http已很强，增量价值几乎全来自收敛这四类开销。
Go语言写高性能框架，核心不是堆功能，而是控制开销：每次内存分配、每次接口断言、每次 goroutine 启动、每次系统调用，都得有明确理由。标准库 net/http 已经足够强，所谓“高性能框架”的增量价值，几乎全来自对这四类开销的收敛。
路由匹配别走 map[string]HandlerFunc 线性查找
大量路由（比如 500+ 条）下，map 查 key + 类型断言 + 函数调用链，延迟会明显上浮。真实压测中，Radix Tree（如 trie）或双数组 Trie 的前缀匹配能稳定在 O(1)~O(m)，m 是路径段数，比遍历 slice 或嵌套 map 快一个数量级。
- 避免手写简单 switch 或 if/else 链处理 /user/:id、/user/:id/profile 这类带参数路由——它不可扩展，且编译期无法优化分支预测
- 注意通配符优先级：/user/:id 和 /user/me 冲突时，必须让静态路径 /user/me 先于动态段匹配，否则
:id会吞掉所有子路径 - 如果框架要支持正则路由（如 /post/(?P<id>\d+)），务必缓存已编译的
*regexp.Regexp实例，别在每次请求里重复regexp.Compile
中间件链别用 []func(Next) 形式做递归调用
典型错误是把中间件定义成 type Middleware func(http.Handler) http.Handler，然后靠闭包层层包裹 handler。这会导致每次请求都新建 N 层函数对象，逃逸到堆上，GC 压力陡增；同时调用栈深度增加，影响内联优化。
- 改用扁平化执行器：把所有中间件注册为
func(*Context)切片，在serveHTTP中 for 循环调用，用ctx.Next()控制流程，避免闭包嵌套 - Context 不要反复 new：复用
sync.Pool分配*Context，尤其注意其中的Values字段（通常是map[any]any）——池化时需清空，否则脏数据会跨请求泄露 - 鉴权、日志等中间件，若只读不改请求体，尽量跳过
io.Copy或bytes.Buffer包装，直接透传http.ResponseWriter
HTTP 处理别碰 io.WriteString 和 fmt.Fprintf
响应头和响应体拼接阶段，io.WriteString(w, "HTTP/1.1 200 OK
") 看似简洁，但底层会触发多次小 write 系统调用；而 fmt.Fprintf 更糟，它内部有格式解析、参数反射、临时字符串拼接三重开销。
立即学习“go语言免费学习笔记（深入）”；
- 用预分配字节切片 +
strconv.AppendXXX构建状态行和 header，例如：buf = append(buf, "HTTP/1.1 200 OK Content-Length: "...)，再一次性w.Write(buf) - 响应体如果是 JSON，别用
json.Marshal+w.Write两步——改用json.NewEncoder(w).Encode(v)，它内部做了 buffer 复用和流式写入 - 如果框架暴露了
WriteHeader和Write的 hook，确保用户自定义 writer 不会无意中触发Flush，那会强制拆包、破坏 TCP Nagle 算法合并效果
goroutine 泄漏比性能差更致命
很多“高性能”框架在连接关闭时没正确 cancel context，导致 handler goroutine 卡在 time.Sleep、chan recv 或数据库 query 上，持续占用栈内存和调度资源。k6 压测跑 5 分钟后 RSS 增长 300MB，八成是这个原因。
- 每个连接 handler 必须绑定
req.Context()，所有阻塞操作（DB 查询、RPC 调用、定时器）都要传该 ctx，并监听Done() - 别在中间件里无条件启动 goroutine，例如 “记录访问日志” 写成
go log.Info(...)—— 日志库本身应支持异步刷盘，而非靠用户手动 go - 测试时用
runtime.NumGoroutine()+ pprof/goroutine 持续观察，连接断开后 1 秒内 goroutine 数应回落到基线值附近
真正难的不是写出零 GC 的代码，而是让每一处“为了性能加的逻辑”都可被关掉、可被验证、可被回滚。比如 Radix Tree 路由在路由少于 10 条时反而比 map 慢，这时框架得允许 fallback；又比如 sync.Pool 在低并发下可能因碎片反而降低性能——这些边界条件，文档不会写，但线上会咬人。
