Go 语言如何编写高性能的 API 接口

Go 语言写高性能 API，核心还真不是堆协程或者换个什么“更快”的框架——关键在于控制资源生命周期、避免隐式阻塞，以及把 HTTP 处理链路尽可能缩短。标准库 net/http 本身已经足够快，真正的瓶颈往往藏在 handler 内部：那些同步的数据库调用、没有被复用的 JSON 解码器、还有无节制启动的 goroutine。

别在 handler 里直接启动无限制 goroutine

一个很常见的坑是：看到“异步”就顺手写 go func() { ... }()。高并发一来，瞬间拉起成千上万个 goroutine，内存和调度器直接吃不消。

• 用带缓冲的 channel 或者 worker pool 来控制并发数，比如 semaphore.NewWeighted(10)（来自 golang.org/x/sync/semaphore）来做限流，就很实用
• 耗时操作——像发 HTTP 请求、写日志到磁盘——一定要设超时。context.WithTimeout(ctx, 3*time.Second) 这一步不能省略
• 不要在 goroutine 里直接写 response。HTTP 连接可能已经关闭了，write on closed network connection 这个错误就是这么来的

JSON 编解码要复用 encoder/decoder 实例

每次请求都 new json.NewDecoder(r.Body) 或者 json.NewEncoder(w)，会频繁触发内存分配，GC 压力一下就上去了。

• 可以考虑在 handler 外面用 sync.Pool 来管理 *json.Decoder 和 *json.Encoder，复用起来效率高很多
• 注意 Decoder 在复用前需要调用 UseNumber()，避免 float64 精度丢失——尤其处理 ID 字段的时候
• 如果结构体字段固定且简单，实测 encoding/json.Marshal + bytes.Buffer 比 streaming encoder 更快，可以试试

路由和中间件链必须轻量

用 Gin 或 Chi 没问题，但别在每一层中间件里都做全量日志、完整 body 读取、JWT 全字段校验——这些动作应该按需延迟执行。

• 日志中间件只记录 method、path、status、latency，不记录 request body；需要 debug 时再单独加开关
• 认证中间件用 r.Header.Get("Authorization") 提取 token 后，只验证签名和过期时间，用户信息可以延迟加载
• 避免在中间件里调用 ioutil.ReadAll(r.Body)——它会一次性读完整个请求体，后续 handler 再读就空了

数据库和外部依赖必须走连接池 + 上下文传播

没有上下文的 DB 查询等于放弃了超时控制；没有连接池的 HTTP client 会快速耗尽文件描述符，这都是生产环境常见的隐患。

• database/sql 的 SetMaxOpenConns 和 SetMaxIdleConns 必须显式设置。生产环境建议 MaxOpenConns=20 起步
• 所有外部调用——DB、Redis、HTTP——都要传入 ctx，并确保上游 context 有 deadline
• 用 http.DefaultClient 很危险，它没有超时，也没有连接池配置。应该自定义 &http.Client{Timeout: 5 * time.Second, Transport: ...}

说到底，真正卡住性能的，往往不是语法或者框架选型，而是某次忘记关的 rows.Close()、某个没设超时的 http.Get、或者一个反复 new 出来的 map[string]interface{}。高频路径上的每一行代码，都要能回答三个问题——它分配内存了吗？它会阻塞吗？它能被取消吗？