Beego 文件系统缓存的单实例限制与多缓存目录正确实现方案_技术教程

beego 的 cache.newcache("file", ...) 不支持为同一缓存适配器（如 "file"）创建多个独立实例——后续调用会覆盖前一个配置并复用同一底层对象，导致多目录缓存行为混乱。

Beego 的文件系统缓存（"file" 适配器）在设计上是单例模式：其内部通过全局变量 adapters["file"] 存储已注册的缓存实例（见 cache/cache.go#L84）。当你连续两次调用 cache.NewCache("file", config1) 和 cache.NewCache("file", config2) 时，第二次调用不仅会用 config2 重新初始化该适配器的全局状态，还会返回同一个指针地址的对象——因此 MyCache 和 OtherCache 实际指向同一底层缓存实例，所有读写操作均作用于最后配置的目录（即 .cache/othercache），造成数据混杂。

这并非你代码逻辑错误，而是 Beego 缓存模块的固有限制：它不允许多个独立的文件系统缓存实例共存于同一进程。

✅ 正确解决方案

方案一：使用唯一键前缀 + 单缓存实例（推荐）

保持单一 file 缓存，但为不同业务域添加命名空间前缀，便于隔离与批量清理：

const (
    MyCachePrefix    = "my:"
    OtherCachePrefix = "other:"
)

func keyWithPrefix(prefix, key string) string {
    return prefix + key
}

// 初始化单个文件缓存
var SharedCache cache.Cache

func Init() {
    var err error
    SharedCache, err = cache.NewCache("file", `{
        "CachePath":".cache/shared",
        "FileSuffix":".cache",
        "DirectoryLevel":2,
        "EmbedExpiry":600
    }`)
    if err != nil {
        log.Fatal("Failed to init shared cache:", err)
    }
}

func writeMyCache(key, value string, expire int64) error {
    return SharedCache.Put(keyWithPrefix(MyCachePrefix, key), value, expire)
}

func readMyCache(key string) (string, bool) {
    if v := SharedCache.Get(keyWithPrefix(MyCachePrefix, key)); v != nil {
        return v.(string), true
    }
    return "", false
}

// 同理实现 OtherCache 的封装函数...

✅ 优势：符合 Beego 设计约束；支持原子性清理（如 os.RemoveAll(".cache/shared/my_")）；线程安全；零额外依赖。

方案二：切换至支持多实例的缓存库（进阶）

若需真正物理隔离（如不同 TTL、不同磁盘路径、独立锁机制），建议替换为更灵活的缓存库，例如 gocache 或原生 sync.Map + 自定义文件持久化：

import "github.com/eko/gocache/cache"

myCache := cache.NewCache(
    cache.NewFileCache(".cache/mycache", cache.WithFileSuffix(".cache")),
)
otherCache := cache.NewCache(
    cache.NewFileCache(".cache/othercache", cache.WithFileSuffix(".cache")),
)