Go sync.Pool 复用对象的清空时机与引用泄漏边界

Go 的 sync.Pool 适合缓存短生命周期、可安全丢弃的临时对象。正确的复用边界是：Get 后先覆盖或重置状态，使用期间保持独占，所有同步消费者完成后再 Reset 并 Put。不要把 Pool 当成业务缓存，也不要在对象归还后继续使用它的指针或切片。

sync.Pool 先解决分配压力，不负责保存业务状态

sync.Pool 的定位是临时对象池：多个独立调用方可以短暂借用对象，减少反复分配带来的垃圾回收压力。官方文档同时强调，池中的项目可能在任意时刻被自动移除，所以业务结果、会话状态、待处理队列都不应该放进 Pool。

New 只是在 Get 没有可返回对象时提供创建函数；Get 返回的是任意可用项目，调用方不应假设它对应某一次 Put。因此对象拿到手后，要由调用方明确初始化：

package main

import (
    "bytes"
    "sync"
)

var bufferPool = sync.Pool{
    New: func() any {
        // 返回指针便于复用同一个可变缓冲对象。
        return new(bytes.Buffer)
    },
}

func borrowBuffer() *bytes.Buffer {
    // Get 的结果可能来自上一次使用，也可能由 New 创建。
    b := bufferPool.Get().(*bytes.Buffer)
    b.Reset() // 先清掉旧内容，再交给本次调用。
    return b
}

这里的 Reset 是调用方的初始化责任，不是 Pool 自动替你完成的工作。图中的分组关系用于说明“池负责缓存、调用方负责状态”的边界。

Get 后覆盖、使用中独占、Put 前 Reset

一个可靠的生命周期可以压缩成四个判断：拿到对象时是否清理；写入期间是否只有当前调用方使用；输出是否已经被消费者读完；归还前是否清掉下一次不应看到的状态。以日志缓冲为例，代码可以把归还动作放进同一个函数的尾部：

func writeLog(dst *bytes.Buffer, key, value string) {
    // 本函数独占 dst；调用者不能在并发任务间共享它。
    dst.Reset()
    dst.WriteString(key)
    dst.WriteByte('=')
    dst.WriteString(value)
}

func render(key, value string) []byte {
    b := borrowBuffer()
    defer func() {
        // 返回池前清空内部状态，避免下一次看到旧内容。
        b.Reset()
        bufferPool.Put(b)
    }()

    writeLog(b, key, value)
    // 这里只返回独立副本，避免把 b 的底层存储带出归还边界。
    return bytes.Clone(b.Bytes())
}

若下游只在当前调用栈内同步读取 b.Bytes()，可以在读取结束后归还；若要交给队列、goroutine 或异步回调，应先复制数据，再 Put。复制的成本是明确的，悬挂引用造成的竞态和脏数据则很难定位。

切片和异步任务会把引用边界带出 Pool

bytes.Buffer.Bytes() 返回的是底层数据的视图，不是自动复制。即使调用方没有继续访问 *bytes.Buffer，异步消费者仍可能持有这段切片；此时生产者一旦 Reset、重新写入并把对象放回池，消费者看到的内容就可能变化。

可以用下面的决策表检查归还前的最后一个使用者：

用检查清单判断对象是否适合放入 Pool

适合放入 Pool 的对象通常满足三个条件：生命周期短、内容可以完全重建、缓存失效不会破坏业务正确性。bytes.Buffer、临时编码器、一次请求内使用的构建器比较符合这个模型；连接、锁、带外部句柄的资源和必须持久存在的状态则不适合直接交给 Pool。

• 是否在每次 Get 后覆盖了所有会影响本次结果的字段？
• 是否确认所有切片、指针和嵌套对象在 Put 前不再被外部持有？
• 对象被 GC 或 Pool 自动清掉时，业务是否仍然正确？
• 是否把 Put 放在最后一个同步消费者完成之后？

常见问题

sync.Pool.Get 会不会一定返回刚刚 Put 的对象？

不会。Get 可以返回任意池中项目，也可以把池视为空并调用 New，代码不能依赖具体对象身份。

Put 之后还能读取原来的指针吗？

不应读取。Put 表示调用方不再拥有该对象；下一次 Get 或 GC 都可能改变或移除它。

Reset 是否能替代 bytes.Clone？

不能。Reset 只清理 Buffer 的当前状态，不能撤销已经交给异步消费者的底层切片引用；需要跨生命周期传递时仍应复制数据。