必须替换gorilla/sessions默认Store为Redis实现，否则session仍存内存导致重启丢失、多节点隔离及Values为空；需用NewRedisStore初始化并传入已Ping验证的*redis.Client，结构体字段须加小写下划线json tag，key设计支持精准清理，Session实例禁止跨goroutine复用。
gorilla/sessions不换Store就永远存不到Redis
Session数据始终为空、重启丢失、多实例间无法共享——不是Redis连不上，而是你根本没切到Redis Store。默认的cookie.Store或内存Store仍在后台悄悄工作，sessions.Session.Values写进去就丢，连日志都看不出错。
- 必须显式初始化Redis Store：
store := redis.NewStore(16, "tcp", "redis:6379", "", []byte("secret-key"))，然后gin.Default().Use(sessions.Sessions("mysession", store)) - 别用
redis.NewClient()构造Store底层连接——这会导致每个Store实例持有一个独立redis.Client，连接池隔离、pipeline缓存不共享、健康状态不同步 - 改用全局复用的
redis.Client：先在main.go里globalsessionkeeper.GlobalRedisClient = redis.NewClient(...)，再传给redis.NewStore的第三个参数（需自行封装适配器）
session.Values为空？90%是JSON序列化静默失败
你看到sessions.Session.Values["user"]是nil，但Redis里明明有数据——问题不在网络或超时，而在Go结构体字段没加json tag，或大小写/下划线不匹配导致反序列化失败，且gorilla/sessions不报错。
- 所有要存进Session的struct字段必须显式声明
jsontag，统一用小写下划线风格：UserID int `json:"user_id"`，不能依赖“自动转” - 存之前先
json.Marshal打印日志，确认输出是{"user_id":123}而非{"UserID":123} - 读取时用
json.Unmarshal([]byte(val), &s)，别用result.Scan(&s)——后者走Redis二进制协议，和JSON无关
并发写覆盖、Session ID不唯一、Key设计踩坑
用户登录后刷新页面，部分字段丢失；登出清不干净旧会话；Redis CPU突然飙升——这些都不是偶发bug，而是Session Key设计和并发控制没到位。
-
sessions.Session.Values是普通map[interface{}]interface{}，非线程安全。两个请求同时调session.Save()，后执行的会覆盖前一次写入 - Session ID必须由服务端生成：
uuid.NewString()，严禁接受客户端传来的任意字符串，防碰撞+防伪造 - Key格式别用
"session:" + userID，而要用"sess:" + sessionID；同时维护索引HSET user_sessions:u123 sess:abc123 "2026-08-11T14:50:00Z"，登出时先查再批量DEL，避免KEYS session:user123*触发O(N)扫描 - 每次
client.Set()必须带TTL：client.Set(ctx, key, val, 30*time.Minute)，漏掉就永不过期，Redis内存只增不减
Docker环境连不上Redis？大概率是地址写死了
本地开发时Go服务跑宿主机、Redis跑Docker容器，代码里硬写localhost:6379，结果连不上——这不是Redis没启动，而是localhost指向宿主机自己，压根没进容器网络。
立即学习“go语言免费学习笔记（深入）”；
- Docker Desktop用户：Redis地址改成
host.docker.internal:6379 - Linux Docker用户：用宿主机真实局域网IP（如
192.168.1.100:6379），别用127.0.0.1 - 最稳方案：通过环境变量注入，
REDIS_ADDR=redis:6379，并在docker-compose.yml中确保network_mode为bridge且service名可解析
redis.Client实例的生命周期管理、Session ID生成与校验闭环、以及并发写时的数据竞态控制——这三个点任何一个松动，都会让分布式Session变成定时炸弹。 
