Go语言goroutine怎么安全操作sync.Pool对象池-Golang-PHP中文网

sync.pool.get 返回的是旧实例，必须同 goroutine 内 reset 后才能安全使用；put 前需确保对象彻底用完且无共享，new 函数须返回全新无状态对象并避免副作用。

go语言goroutine怎么安全操作sync.pool对象池

Get 拿到的不是新对象，而是上一次 Put 进去的“旧实例”，字段、底层数组、map 等都可能残留脏数据。Go 不会自动帮你清理，也不会检查你是否重置——它只管扔进去、拿出来。

常见错误是拿到 bytes.Buffer 后直接写入，结果前一个请求的响应体还留在 buf.Bytes() 里；或者对自定义结构体只调了 new(MyStruct)，但没清空 Items []Item 或 Metadata map[string]string。

bytes.Buffer：必须立刻调 buf.Reset()，不能只靠 New 返回新实例
切片字段（如 []byte）：用 s = s[:0] 截断长度，不是 s = nil
map 字段：用 clear(m)（Go 1.21+），或遍历 delete，避免 m = make(map[string]string) 导致逃逸
含 sync.RWMutex 的结构体：Put 前必须重建锁，*o.mu = sync.RWMutex{} 不合法，得用 o.mu = sync.RWMutex{}

Put 不是“归还”，是“放弃所有权”。一旦调用，该对象可能下一毫秒就被其他 goroutine 的 Get 拿走。此时若还有协程在读写它，就会触发数据竞争或 panic。

典型误用场景包括：把正在被 json.Unmarshal 写入的结构体提前 Put；在 defer 里无条件 pool.Put(x)，但 x 已传给后台 goroutine 或闭包捕获；或者 Put 后继续访问字段（比如打印日志）。

HTTP handler 中，Put 必须放在所有逻辑结束之后，不能放在函数开头或中间
用于 io.Copy(dst, src) 的 writer，Put 必须等 io.Copy 返回后手动调用
对象若作为返回值传出（如 return obj），绝对不能 Put
禁止对同一对象多次 Put，尤其在 defer 里未加判断，容易 panic：“putting an object into a pool twice”

New 只在池空时被调用，且不保证线程安全——它会被多个 goroutine 并发执行。它的唯一职责是：返回一个干净、全新、无共享状态的对象。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

错在这里会导致全局污染或阻塞：New 返回全局变量地址（如 &globalBuf），多个 goroutine 共享同一内存；在里面做 http.Get 或打日志；或者预分配超大容量（如 make([]byte, 0, 1MB)）导致 GC 压力陡增。

始终将 sync.Pool 定义为包级变量，例如：var bufferPool = sync.Pool{New: func() interface{} { return &bytes.Buffer{} }}
需要预分配容量的，必须在 New 里完成：return &bytes.Buffer{Buf: make([]byte, 0, 64*1024)}
结构体字段要显式初始化：&MyStruct{Data: make([]byte, 0, 128), Cache: make(map[string]int)}，别依赖零值
禁止返回已存在的指针、禁止调用任何阻塞或带状态操作