如何在 Go 中编写一个高性能的内存对象池-Golang-PHP中文网

sync.pool不是万能缓存工具，因其设计目标仅为临时对象复用：gc时清空未引用对象，不保证复用；误作长期缓存会导致nil或脏数据；需手动重置字段，禁存指针或长生命周期依赖。

如何在 go 中编写一个高性能的内存对象池

为什么 `sync.Pool` 不是万能的缓存工具

sync.Pool 的设计目标不是长期缓存，而是临时对象复用——它会在 GC 时清空所有未被引用的池中对象，且不保证对象一定被复用。如果你把它当 map 用、存配置或连接句柄，下次取出来大概率是 nil 或旧垃圾值。

常见错误现象：对象字段没重置，导致后续使用出现“幽灵数据”；或者误以为池里总能拿到刚放进去的对象，结果逻辑崩溃。

只用于短期、高频、结构固定的对象（比如 JSON 解析用的 bytes.Buffer、HTTP 中间件的上下文容器）
每次从池中取出后，必须手动清零关键字段（不能依赖构造函数）
不要在池中存指针指向外部生命周期更长的数据（如全局 map 的键）

如何正确初始化和重置一个自定义结构体池

直接传 &MyStruct{} 给 sync.Pool{New: ...} 是错的——New 函数返回的是新对象，但 Go 不会自动帮你调用“析构”逻辑。真正关键的是取出后的重置动作，得由使用者负责。

典型场景：一个频繁分配的请求元信息结构体 ReqMeta，含 id string、ts int64、tags map[string]string。

<pre class="brush:php;toolbar:false;">var reqMetaPool = sync.Pool{
    New: func() interface{} {
        return &ReqMeta{
            tags: make(map[string]string, 4),
        }
    },
}

func GetReqMeta() *ReqMeta {
    m := reqMetaPool.Get().(*ReqMeta)
    // 必须重置！否则上一次的 id/tags 可能残留
    m.id = ""
    m.ts = 0
    for k := range m.tags {
        delete(m.tags, k)
    }
    return m
}

func PutReqMeta(m *ReqMeta) {
    reqMetaPool.Put(m)
}