Go weak.Pointer 怎样在缓存中实现可失效引用

Go 的 weak.Pointer 适合放在“可以失效、失效后能够回源重建”的缓存索引里。它不会阻止垃圾回收器回收目标对象，Value() 可能返回 nil；所以正确模型是强引用保存业务数据，weak.Pointer 只保存不拥有生命周期的二级关系，而不是拿弱引用替代主缓存。

先把 weak.Pointer 的生命周期边界说清楚

官方 weak 包从 Go 1.24 起进入标准库，用于弱引用、缓存、规范化映射和弱键关系。普通指针会让对象保持可达；weak.Pointer[T] 不会。只要对象没有其他强引用，垃圾回收后 Value() 就可能返回 nil。这个“可能”也意味着不能用一次测试观察到的结果推断回收时机。

下图把关系拆成三层：业务主存储拥有 *Entry，弱索引只记录对象关系，GC 则决定弱引用何时失效。它是静态结构说明图，不是运行截图或回收结果。

用 weak.Pointer 建立可失效的二级缓存索引

下面的例子用字符串键指向一个可重建的 Entry。items 只保存弱指针，真正的业务数据应由数据库、主缓存或其他仍持有强引用的组件负责；实际项目中的回源函数负责在弱引用失效时重新构造对象。

package weakcache

import (
    "runtime"
    "sync"
    "weak"
)

type Entry struct {
    Key   string
    Value []byte
}

type Cache struct {
    mu    sync.RWMutex
    items map[string]weak.Pointer[Entry]
}

func New() *Cache {
    // 弱索引只做可丢失的加速层，不承担业务数据的唯一存储职责。
    return &Cache{items: make(map[string]weak.Pointer[Entry])}
}

func (c *Cache) Get(key string) (*Entry, bool) {
    c.mu.RLock()
    p, ok := c.items[key]
    c.mu.RUnlock()
    if !ok {
        return nil, false
    }

    // Value 返回强指针；nil 表示对象已经不可达或尚未可用。
    entry := p.Value()
    if entry == nil {
        return nil, false
    }
    // 让对象至少活到本次读取逻辑结束，再交给调用者继续持有。
    runtime.KeepAlive(entry)
    return entry, true
}

func (c *Cache) Put(key string, entry *Entry) {
    if entry == nil {
        return
    }
    c.mu.Lock()
    // Make 不复制对象；调用方仍需在别处保留业务所需的强引用。
    c.items[key] = weak.Make(entry)
    c.mu.Unlock()
}

这里的关键不是“把对象放进 map”，而是接受弱索引随时失效：Get 命中后拿到强指针就可以正常读取；未命中或 Value() 为 nil 时，应调用回源逻辑重新构造对象，再决定是否写回。生产代码还要根据主存储的生命周期设计并发去重，避免多个请求同时回源。

什么时候应该用，什么时候不要用

另一个常见误区是把 KeepAlive 当成“固定缓存”。它只是在强引用已经存在时，把对象的最后可达点推迟到指定位置；不能让弱指针独立拥有对象，也不能保证 Value() 最终一定返回 nil。带 finalizer 的对象还有更早变 nil 的边界，必须按文档语义设计。

常见问题

weak.Pointer 能替代普通 map 缓存吗？

不能。普通 map 中存放的强指针会参与对象可达性；weak.Pointer 只适合作为可丢失的加速关系，失效时必须能够回源。

Value() 返回 nil 是错误吗？

不是，这是弱引用缓存的正常未命中分支。调用方应删除或更新失效索引，并走重建逻辑。

调用 KeepAlive 后对象一定不会被回收吗？

只保证对象在指定调用点之前仍按强引用可达；它不改变 weak.Pointer 的弱引用性质，也不承诺对象永久保留。