如何在 Go 中利用 sync.Pool 复用复杂的业务对象实例-Golang-PHP中文网

sync.Pool适合复用生命周期短、创建开销大且能安全重置的对象，如RequestContext、LogEntry、JSONBuffer；不可复用含未关闭资源、goroutine引用或强状态依赖的对象，须实现New和Reset确保每次Get前已重置。

sync.Pool 适合复用哪些对象

只有生命周期短、创建开销大、且能安全重置的业务对象才值得放进 sync.pool。比如 http 中间件里频繁构造的 requestcontext、日志模块中的 logentry、序列化用的 jsonbuffer。如果对象持有不可重入的资源（如打开的文件描述符、未关闭的数据库连接）、或内部有 goroutine 持有引用、或字段间存在强状态依赖，放进 pool 后取出来直接用大概率 panic 或数据错乱。

常见误用：把带 sync.Mutex 字段但没重置的结构体丢进 Pool —— 下次 Get 到的实例可能仍处于加锁状态；或者把含指针切片的结构体放进去，没清空底层数组，导致旧数据残留。

必须实现 New 和 Reset 两个关键逻辑

sync.Pool 的 New 字段只在 Get 无可用对象时调用，它不负责清理。真正决定对象能否复用的是你是否在每次 Put 前手动重置——Go 不会自动帮你做这件事。

实操建议：

在结构体上定义 Reset() 方法，把所有可变字段设为零值（slice = slice[:0]，map 字段用 clear() 或重新 make，指针字段置为 nil）
New 函数只负责构造干净初始态，不要在里面预分配超大内存（比如 make([]byte, 1），否则 GC 压力陡增
Put 前必须调用 Reset()，哪怕刚从 Pool Get 出来也得重置——因为无法保证上次使用者已清理

示例片段：

type OrderProcessor struct {
    ID        int64
    Items     []Item
    Metadata  map[string]string
    mu        sync.RWMutex
}

func (o *OrderProcessor) Reset() {
    o.ID = 0
    o.Items = o.Items[:0]
    clear(o.Metadata)
    o.mu = sync.RWMutex{} // 注意：Mutex 不能 copy，必须重建
}

var processorPool = sync.Pool{
    New: func() interface{} {
        return &OrderProcessor{
            Items:    make([]Item, 0, 16),
            Metadata: make(map[string]string),
        }
    },
}

注意 Get/Put 的调用时机和 goroutine 边界

sync.Pool 是 per-P 的本地缓存，对象只在同个 P 内复用。一旦 goroutine 被调度到另一个 P（比如阻塞后唤醒），之前 Put 的对象就不可见了。这意味着：

使用Go语言搭建家庭相册系统-相关课件

下载

不能在 goroutine A 中 Put，在 goroutine B 中期望 Get 到它（除非 B 与 A 固定绑定在同一 P，这几乎不可能）
HTTP handler 中，每个请求对应一个 goroutine，应在 handler 入口 Get，出口 Put —— 不能跨请求复用
异步任务（如 go fn()）中使用 Pool 对象时，必须在该 goroutine 内完成 Get + 使用 + Put 全流程，不能把对象传给其他 goroutine

典型错误：在 defer 中 Put，但函数提前 return 导致 defer 未执行，对象永久泄漏出 Pool；或者 Put 了已被 GC 标记为“待回收”的对象（比如 Put 了一个局部变量地址，而该变量逃逸失败）。