用 weak.Pointer 构建可自动失效的元数据缓存

如果元数据缓存只用普通指针，缓存表本身就会把每个对象一直留在可达对象图里；定时清理又很难和真实访问节奏匹配。Go 1.24 提供的 weak.Pointer 给了一个更窄的选择：缓存只保存弱句柄，对象没有其他强引用时可以被 GC 回收，下次读取再回源构建。

这个方案的关键不是“让缓存按时间自动过期”，而是把缓存明确定位成可丢弃副本。Value() 可能得到 nil，但 GC 何时运行、对象何时真正不可达都不应被拿来做业务时钟。

先把 weak.Pointer 当成可失效句柄

weak.Pointer[T] 与 *T 的差别在于可达性。普通指针会让对象保持可达，弱指针不会；当对象已经没有其他强引用时，运行时允许回收它，此后 Value() 可能返回 nil。因此，弱指针适合保存“重新计算也能得到”的元数据，不适合保存订单状态、权限结果或唯一业务对象。

Value() 返回非 nil 后，当前调用拿到了一个强指针，可以正常读取对象。反过来，Value 返回 nil 只说明这次句柄不能恢复对象，并不等价于“刚刚发生了回收事件”，更不代表可以精确推导出缓存存活时长。

设计元数据缓存的键、值和重建边界

下面的缓存以字符串键索引元数据。表里只放 weak.Pointer[Metadata]，真正的 Metadata 由 loader 创建。这样，缓存容量增长时不会单凭缓存表阻止元数据回收。

package metacache

import (
    "fmt"
    "sync"
    "weak"
)

type Metadata struct {
    Name   string
    Fields []string
}

type Cache struct {
    mu    sync.Mutex
    items map[string]weak.Pointer[Metadata]
}

func New() *Cache {
    // 句柄表可长期存在，但它不应强持有每个 Metadata。
    return &Cache{items: make(map[string]weak.Pointer[Metadata])}
}

func (c *Cache) Get(key string, loader func(string) (*Metadata, error)) (*Metadata, error) {
    c.mu.Lock()
    handle, ok := c.items[key]
    c.mu.Unlock()

    if ok {
        // Value 把仍然存活的对象临时恢复成强指针。
        if value := handle.Value(); value != nil {
            return value, nil
        }
    }

    // 缓存失效或未命中时回源；不要在锁内执行慢加载。
    value, err := loader(key)
    if err != nil {
        return nil, fmt.Errorf("load metadata %q: %w", key, err)
    }
    if value == nil {
        return nil, fmt.Errorf("loader returned nil metadata for %q", key)
    }

    c.mu.Lock()
    // 回写的是弱句柄，后续没有其他强引用时仍可被回收。
    c.items[key] = weak.Make(value)
    c.mu.Unlock()
    return value, nil
}

这里有一个容易忽略的事实：函数返回的 value 是强引用，所以调用方仍在使用它时不会因为缓存使用弱句柄而突然消失。下一次调用是否命中，取决于上一次返回值是否还被业务代码持有，以及 GC 是否已经让句柄失效。

处理并发读写与失效竞态

示例用互斥锁保护 map，但把 loader 放在锁外。多个 goroutine 可能同时发现同一个弱句柄已经失效，并各自构建一份元数据；这不是数据竞争，因为每份对象都独立，最后一次回写只决定未来的缓存入口。

如果加载元数据很重，可以在锁外增加按 key 合并请求的 singleflight 层；不要为了消除重复构建而把整个 loader 放进全局锁。写入新句柄前也不需要把旧对象“强行复活”，旧句柄失效正是缓存可回收的正常路径。

验证适用场景和不能替代的能力

把下面这张表当成接入前的快速检查。只要“回源不可用”或“数据不能丢”，就不应仅靠 weak.Pointer 保证正确性。

如果某段代码暂时只剩弱句柄，却还必须让对象保持可达，应保留一个强引用，并在最后一次使用之后调用 runtime.KeepAlive。不过，KeepAlive 是延长当前强引用生命周期的工具，不是让 weak.Pointer 变成强指针的办法。

延伸问答：weak.Pointer 缓存的两个边界

weak.Pointer 能实现固定时间过期吗

不能。它表达的是 GC 可达性，不是时间。固定 TTL 应记录时间并主动判断，二者可以组合，但不能互相替代。

Value 返回 nil 后要删除 map 项吗

可以删除以减少句柄表噪声，也可以直接覆盖新句柄。若采用并发清理，仍要让删除和写入经过同一把锁，避免把新值误删。

缓存对象需要持久化时还能用 weak.Pointer 吗

只能把它作为加速层。真实数据必须放在数据库、文件或其他可恢复来源中，缓存失效后重新读取，不能把弱句柄当作持久化存储。