不能用sync.Map做文件块缓存层，因其无TTL、不支持区间查询、无容量限制与淘汰回调，导致内存泄漏、句柄耗尽、并发删除低效及TTL失效；应改用bigcache存元信息+ mmap零拷贝，二级用flock保护的分层SSD落盘。
Go 实现多级文件缓存，不能靠 sync.Map + os.ReadFile 拼凑，否则会卡在内存泄漏、文件句柄耗尽、并发读写冲突、TTL 失效这四点上——尤其当文件块按偏移切片索引时，sync.Map 根本不支持范围查询和局部过期。
为什么不能用 sync.Map 做文件块缓存层
sync.Map 是线程安全的键值容器，不是缓存。它没有 TTL 控制，无法按访问时间淘汰冷块；不支持基于 offset/size 的区间命中判断；更没法配合 mmap 做零拷贝读取。你存一个 "file:abc:0-65536"，下次查 "file:abc:16384-32768" 就得全量扫描 key —— 这在 GB 级文件缓存里直接 OOM。
- 文件块 key 本质是区间（start, end），而
sync.Map只支持精确 key 匹配 - 没容量限制，
bigcache或freecache能设maxEntries和内存上限，sync.Map会把所有块全留在内存直到进程退出 - 无淘汰回调，无法触发
munmap或关闭 fd，文件句柄数暴涨后too many open files报错 - 不支持原子性批量删除（比如删掉某个文件所有块），只能遍历 delete，高并发下锁争抢严重
一级缓存：用 bigcache 存热点块元信息，而非原始数据
别把整个 64KB 文件块塞进内存缓存。一级只存「元信息」：hash、offset、size、mmap_addr（或 fd + offset）、expire_at。原始数据走 mmap 映射到虚拟内存，由 OS 管理页回收。
- 初始化
bigcache.NewBigCache时必须传OnRemove回调，在淘汰时调用munmap或close(fd) - key 设计用
fmt.Sprintf("%s:%d:%d", fileHash, start, size)，避免字符串拼接逃逸 - 不要用
time.Now().Unix()算过期时间——容器环境时钟漂移会导致块永远不淘汰；改用单调时钟：runtime.nanotime()+ TTL 微秒偏移 - 命中后不 copy 数据，而是返回
unsafe.Pointer+ length，由上层做slice切片（需确保 mmap 区域未被 unmapped）
二级缓存：本地 SSD 上用固定目录结构落盘完整文件
二级不是简单 os.WriteFile，要解决并发写冲突、磁盘满、哈希碰撞三件事。路径必须分层，且每个文件写入前加 flock。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 目录结构强制为
./cache/{hash[0:2]}/{hash[2:4]}/{full_hash}，避免单目录 inode 过载 - 写入前用
syscall.Flock(fd, syscall.LOCK_EX)加排他锁，防止多个 goroutine 同时写同一文件 - 写完立即
syscall.Fdatasync(fd)，确保落盘后再更新元数据，避免断电丢数据 - 磁盘配额检查放在写入前：用
unix.Statfs查Bavail，剩余空间 mtime 删除最老文件）
三级回源：MinIO/S3 对象存储必须带 ETag 验证和异步写入
从对象存储拉取文件不能阻塞主流程，且必须校验完整性。ETag 不等于 MD5，S3 的 ETag 是分块 MD5 拼接 + 分块数，MinIO 默认是纯 MD5 —— 必须显式配置一致。
- 回源时加
If-None-Matchheader，用对象的 ETag 触发 304，避免重复下载 - 下载完成后立即计算 SHA256，与对象的
x-amz-meta-sha256（或自定义 header）比对，不一致则删本地缓存并告警 - 写入二级缓存必须异步：
go func() { writeToFile(); updateL1Meta() }()，主流程只等下载完成 - 对象 key 命名带业务前缀和版本号，如
files/v2/<full_hash></full_hash>，避免升级时缓存污染
真正难的不是每层怎么存，而是三层之间的时间窗口博弈：L1 的 expire_at、L2 的 mtime、S3 的 Last-Modified，三者只要差 200ms，就可能让客户端拿到旧缩略图或损坏的块。别依赖系统时钟，所有时间戳统一用 runtime.nanotime() + 单调偏移。
