Go weak.Make 怎样建立弱引用缓存并控制生命周期

如果一个缓存的目标是“有其他代码使用时复用，没有人使用时允许回收”，Go 1.24 以后可以考虑 weak.Make。它返回 weak.Pointer[T]，缓存只保存这个弱指针，不会因为缓存本身继续持有对象而阻止垃圾回收。读取时调用 Value()，返回 nil 就按缓存未命中处理。

官方地址：https://go.dev/pkg/weak/

weak.Make 只保存弱引用，缓存不应反向持有对象

普通缓存通常是 map[string]*Entry：只要键还在，值就一直可达。弱引用缓存则把值改成 weak.Pointer[Entry]。这适合文件映射、规范化对象或可重新构建的派生数据，但不适合“必须命中”的配置、连接和业务主数据。

弱指针只描述“曾经指向哪个对象”。当对象不再被其他强引用可达时，垃圾回收器可以回收它；此后 Value() 允许返回空指针。代码不能把弱指针当作永久地址，也不能只判断 map 中是否存在键。

用 weak.Make 和 Value 建立最小缓存模型

下面的示例把可重建的 Document 放进缓存。为了让文章聚焦生命周期，示例省略了具体解析过程，只保留“读取、命中、失效后创建”的关系：

package main

import (
    "fmt"
    "weak"
)

type Document struct {
    Name string
}

var documentCache = map[string]weak.Pointer[Document]{}

func loadDocument(name string) *Document {
    if pointer, ok := documentCache[name]; ok {
        if document := pointer.Value(); document != nil {
            // 弱指针仍然有效时，直接复用当前对象。
            return document
        }
    }

    document := &Document{Name: name}
    // 缓存只保存弱引用，后续没有强引用时允许回收。
    documentCache[name] = weak.Make(document)
    return document
}

func main() {
    document := loadDocument("guide.md")
    fmt.Println(document.Name)
}

这里的关键不是 map，而是值类型：weak.Pointer[Document]。第一次调用返回强引用变量 document；函数外若仍保存它，弱指针通常还能重新取回同一个对象。强引用消失后，下一次 Value() 得到 nil 并重新创建对象是正常路径，不应记录成异常。

把 Value 判空和 KeepAlive 放在正确边界

Value() 成功返回后，先把结果放入局部强指针，再继续读取字段或调用方法。不要写出只依赖弱指针的长链路，也不要为了“让缓存一直命中”把对象重新塞进一个全局强引用容器。

func useDocument(name string) (string, bool) {
    pointer, ok := documentCache[name]
    if !ok {
        return "", false
    }

    document := pointer.Value()
    if document == nil {
        // 弱引用失效后，让上层决定是否重建，而不是解引用 nil。
        return "", false
    }

    // 后续操作使用强引用 document，避免只依赖 weak.Pointer。
    result := document.Name
    return result, true
}

需要更严格的可达性边界时，官方文档建议在最后一次必须保持对象存活的位置之后使用 runtime.KeepAlive(document)。它不是“延长缓存寿命”的开关，而是告诉运行时：这段操作完成前，调用方仍然需要这份强引用。

用检查表决定是否采用弱引用缓存

还要注意并发：示例中的普通 map 不是并发安全实现。生产代码应使用互斥锁或并发安全容器，并在“读取旧弱指针、创建新对象、替换条目”之间设计一致性策略。弱引用解决的是回收关系，不会自动解决竞态、重复创建或淘汰时机。

常见问题

weak.Pointer.Value 为什么会突然返回 nil？

因为原对象已经没有其他强引用可达，垃圾回收器允许回收它。弱指针所在的 map 仍存在，并不代表对象仍然存活。

weak.Make 会复制传入的对象吗？

不会。它创建的是指向原对象的弱指针，读取结果仍是原对象指针或 nil。

弱引用缓存一定比普通缓存省内存吗？

不一定。它减少的是缓存对对象存活的影响，但会增加失效后的重建成本、并发控制和空值处理，必须结合对象大小与重建代价决定。