关键在于抽象统一接口并按需注入适配器：定义含get/set/delete/clear方法的存储接口，分别实现内存（sync.map）、session（gorilla/sessions封装）和local（磁盘json）三种适配器，通过依赖注入和上下文动态切换，业务代码无需感知底层差异。
要实现 local、session 和内存存储的无缝切换，关键不是写三套逻辑，而是统一访问入口、隔离实现细节、按需注入适配器。核心在于抽象出一致的接口，让上层业务完全不感知底层是文件、Redis 还是 Go map。
定义统一的存储接口
所有适配器必须实现同一组方法，比如：
- Get(key string) (interface{}, error)：读取任意类型值（支持 session 数据或文件元信息）
- Set(key string, val interface{}, ttl time.Duration) error：写入并支持过期（session 需 TTL，内存缓存也需淘汰）
- Delete(key string) error
- Clear() error：用于 session 注销或内存清空
注意：接口返回值用 interface{} 而非 []byte，便于 session 存结构体、local 存路径字符串、内存存原始对象——序列化/反序列化由各适配器内部处理。
分别实现三类适配器
内存适配器（InMemoryAdapter）：基于 sync.Map 或带锁 map，轻量、无依赖，适合开发环境或单机轻量服务。
- Set 时自动记录写入时间，Clear 直接遍历清理
- 不支持持久化，但可加 LRU 驱动（如使用
gocache库）控制大小
Session 适配器（SessionAdapter）：包装标准 session.Store（如 gorilla/sessions），把 key 映射为 session 字段名。
- Get 从 session.Values 里取值；Set 写入后调用
session.Save() - 利用 session 自带的 TTL 和签名机制，天然防篡改
- 适用于用户登录态、临时表单数据等需绑定请求生命周期的场景
Local 适配器（LocalAdapter）：对接本地磁盘，但不直接暴露路径操作。
- Set 实际写入文件（如
json.Marshal后保存到./storage/{key}.json） - Get 读取并
json.Unmarshal，失败则返回 nil + error - Clear 即递归删除对应目录，适合缓存配置、离线资源等中长期数据
运行时动态切换策略
切换不靠 if-else，而靠依赖注入和上下文识别：
- 启动时根据环境变量（如
STORAGE_TYPE=memory）调用工厂函数NewStorage("memory")创建实例 - HTTP 中间件中，从请求头（如
X-Storage-Mode: session）提取偏好，临时覆盖当前请求的存储实例 - 对关键操作（如用户上传头像），强制走 local；对临时验证码，走 memory；对登录态，走 session —— 由业务路由决定，非全局硬编码
注意事项与边界处理
三种存储语义不同，不能简单“互换”：
- session 不支持跨请求 Set 后 Get（除非显式 Save），local 和 memory 支持；需在文档中标明行为差异
- memory 无持久性，local 无并发安全（需加文件锁或改用 boltdb），session 有默认 24h 过期 —— 各自的约束要在适配器内部封装，不向上暴露
- Key 命名需统一规范（如
user:123:profile），避免 local 写入时因斜杠生成子目录，而 memory 报错
真正无缝，是让业务代码始终调用 store.Set("cart_id", cart, 30*time.Minute)，而不关心这行代码背后是 Redis HSET、disk write 还是 map.Store。
