应换 httprouter（Radix Tree、零分配）或 chi（模块化、中间件友好），避免 net/http ServeMux 的线性遍历和正则硬编码；前者性能更高，后者更易扩展。
路由匹配慢？别用 net/http.ServeMux 做动态路径
net/http.ServeMux 只支持前缀匹配，/api/users/:id 这类带参数的路径它根本认不出来。硬写 strings.Split(r.URL.Path, "/") 或正则匹配，每次请求都触发全量遍历或正则编译，QPS 上不去还容易卡住。
直接换 httprouter 或 chi：
-
httprouter基于 Radix Tree，零内存分配，r.GET("/api/users/:id", userHandler)匹配是 O(log n)，压测下比 ServeMux 快 3–5 倍 -
chi支持嵌套中间件和通配符，r.Route("/api", func(r chi.Router) { r.Use(authMiddleware); r.Get("/users/{id}", userHandler) })更适合需要鉴权、日志等组合逻辑的场景 - 千万别在路由函数里做业务判断——比如根据
req.Header.Get("X-Region")动态选后端，这会让路由表膨胀且无法缓存，该逻辑应交给中间件或反向代理层
反向代理卡顿？别直接 new httputil.NewSingleHostReverseProxy
默认的 httputil.NewSingleHostReverseProxy 是玩具级配置：连接不复用、超时不设、错误不重试、Header 透传不校验，高并发下几秒就耗尽 fd 或卡死在 read tcp。
必须显式定制 Director 和 Transport：
立即学习“go语言免费学习笔记（深入）”；
-
Director要清除原始Host头防注入：req.Host = u.Host; req.URL.Scheme = u.Scheme; req.URL.Host = u.Host -
http.Transport至少设：MaxIdleConns: 100、MaxIdleConnsPerHost: 100、IdleConnTimeout: 30 * time.Second；TLS 场景加TLSClientConfig: &tls.Config{InsecureSkipVerify: false} - 务必替换
ProxyErrorHandler，否则后端返回 502/503 时网关只吐空响应，而不是透传真实状态码
限流总失效？rate.Limiter 在多实例下就是摆设
golang.org/x/time/rate.Limiter 只作用于当前进程 goroutine，单机跑着没问题，一上 Kubernetes 多副本，限流立刻归零——每个实例各自计数，流量直接绕过阈值。
真要跨节点限流，得换方案：
- 本地兜底 + 中央存储：用
rate.Limiter做单机快速拒绝（防打爆），再用 Redis + Lua 脚本做全局计数（如INCRBY+EXPIRE组合） - 避免用时间窗口硬切分（如每秒 reset），改用滑动窗口或令牌桶持久化存储，否则窗口边界易被刷爆
- 注意 Redis RTT：高频限流建议走本地 LRU cache + 定期同步，别每请求都
redis.Do("INCR", key)
插件热加载失败？plugin.Open() 不是 runtime.LoadPlugin
Go 的 plugin 包不是“扔个 .so 进目录就能用”，它有硬性约束：
- 插件二进制必须用
go build -buildmode=plugin编译，普通go build生成的文件plugin.Open()直接 panic - 不能在
http.HandlerFunc里实时调用plugin.Open()—— 文件锁冲突 + 符号解析开销大，应启动时预加载并缓存到sync.Map - 插件必须实现统一接口，比如
type Plugin interface { Init(config map[string]interface{}) error; Execute(c *gin.Context) error }，否则网关无法识别调度
真正麻烦的是 ABI 兼容：插件和主程序必须用完全相同的 Go 版本、相同 CGO 环境、相同依赖版本编译，差一个 patch 版本就可能 symbol not found。线上环境建议优先用配置驱动的中间件注册，而非二进制插件。
