Golang 实现一个基于文件的轻量级缓存系统-Golang-PHP中文网

不能直接用os.openfile读写缓存文件，因存在并发写入错乱、无过期判断、非原子更新致读到半写状态三坑；正确做法是分文件存储、rwmutex控并发、临时文件+rename原子替换、filepath.join安全拼路径。

golang 实现一个基于文件的轻量级缓存系统

为什么不用 `os.OpenFile` 直接读写缓存文件

直接用 os.OpenFile 读写单个文件做缓存，看似简单，实际会踩三个坑：并发写入时文件内容错乱、没有过期判断逻辑、无法原子更新导致读到半写状态。缓存不是“存进去再读出来”就行，得保证一致性、时效性和线程安全。

正确做法是把每个缓存项拆成独立文件（key.hash），配合 sync.RWMutex 控制目录级并发，再用 os.Stat 检查 ModTime 判断是否过期。这样既避免锁粒度太粗，又绕开了文件锁的平台差异问题。

文件名用 fmt.Sprintf("%x", md5.Sum([]byte(key))) 生成，避免特殊字符和路径穿越
写入前先写临时文件（tmp_ + hash），os.Rename 原子替换，防止读取中断
读取时先 os.Stat 检查是否存在且未过期，再 os.ReadFile，不缓存文件句柄

如何让 `cache.Get` 返回类型安全的值而不是 `[]byte`

Go 没有泛型运行时擦除，硬编码 interface{} 会导致每次都要类型断言，还容易 panic。更稳妥的方式是把序列化逻辑下沉到调用方，缓存层只管存/取 []byte，由上层决定用 json.Marshal 还是 gob.Encoder。

示例中定义 type Cache interface { Get(key string) ([]byte, error); Set(key string, data []byte, ttl time.Duration) error }，使用者按需封装：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

func (c *FileCache) GetString(key string) (string, error) {
    b, err := c.Get(key)
    if err != nil {
        return "", err
    }
    return string(b), nil
}

func (c *FileCache) GetJSON(key string, v interface{}) error {
    b, err := c.Get(key)
    if err != nil {
        return err
    }
    return json.Unmarshal(b, v)
}

不要在缓存内部做 json.Unmarshal —— 错误堆栈会指向缓存代码而非业务层
如果大量使用结构体，建议统一用 gob（比 JSON 小且快），但注意 gob 不兼容跨版本 Go 运行时
对字符串/数字等简单类型，直接存 []byte 最省事，避免序列化开销

`filepath.Join(cacheDir, hash)` 为什么不能省略 `filepath.Join`

有人图省事拼字符串：cacheDir + "/" + hash，这在 Windows 下直接失效 —— 路径分隔符是 \，而且 cacheDir 结尾可能带或不带斜杠，拼出来可能是 C:\cache//abc123 或 /tmp/cache\abc123，os.Stat 一律返回 stat cache//abc123: no such file。

filepath.Join 自动处理不同系统的分隔符，并清理重复斜杠和首尾分隔符
务必对 cacheDir 做 filepath.Clean 预处理，防止传入 ../etc/passwd 类路径穿越参数
初始化时用 os.MkdirAll(cacheDir, 0755) 创建目录，否则首次 Set 会因父目录不存在而失败

缓存清理策略：不依赖定时器，靠 `Set` 时顺手删过期文件

为轻量级缓存单独起 goroutine 跑定时清理，既增加复杂度又浪费资源。实际观察发现，90% 的过期文件是在 Set 新值时被覆盖或自然淘汰的 —— 更合理的做法是在每次 Set 前扫描并删除一批过期文件（比如最多删 10 个），用 time.Now().Add(-ttl) 对比 os.FileInfo.ModTime()。