hash比string更适合存储会话数据，因其支持字段级更新、节省内存、避免全量序列化反序列化，且天然契合“读多写少、局部更新”的微服务会话访问模式。
为什么不用 Redis String 而选 Hash 存储会话上下文
因为会话上下文通常包含多个字段（如 user_id、role、last_active_at、ip），用 SET 存整个 JSON 字符串会导致每次更新都要序列化/反序列化全部字段，且无法利用 Redis 原子操作做局部更新。Hash 天然支持按字段读写，HGET/HSET 可精确操作单个 key-value 对，还能用 HGETALL 一次性拉全量，更贴合微服务中“读多写少、局部更新”的会话访问模式。
Go 中用 github.com/go-redis/redis/v9 操作 Hash 的关键写法
注意别直接用 client.Set 或 client.Get，必须用 HSet、HGetAll、HGet 等 Hash 专属方法。示例：
ctx := context.Background()
// 写入会话字段（支持批量）
err := client.HSet(ctx, "session:abc123", map[string]interface{}{
"user_id": "u_789",
"role": "admin",
"ip": "10.0.1.5",
}).Err()
if err != nil {
log.Fatal(err)
}
// 读取单个字段
role, err := client.HGet(ctx, "session:abc123", "role").Result()
// 读取全部字段（返回 map[string]string）
fields, err := client.HGetAll(ctx, "session:abc123").Result()
-
HSet第二个参数支持map[string]interface{}或键值对切片（如[]string{"user_id", "u_789", "role", "admin"}） -
HGetAll返回的是map[string]string，所有值都是字符串；若存的是数字或时间戳，需自行转换类型 - 字段名建议统一小写加下划线（如
last_active_at），避免大小写混用导致读取失败
设置过期时间必须用 EXPIRE，不能靠 HSET 自带 TTL
Redis Hash 本身不支持字段级 TTL，整个 key 的过期时间需单独调用 EXPIRE。常见错误是只写 HSet 就以为会话自动过期：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
// ❌ 错误：HSet 不接受过期参数 client.HSet(ctx, "session:abc123", data) // ✅ 正确：先写 Hash，再设 TTL client.HSet(ctx, "session:abc123", data) client.Expire(ctx, "session:abc123", 30*time.Minute)
- 务必在
HSet成功后再执行Expire，否则可能 key 不存在导致 TTL 设置失败 - 推荐封装成原子操作函数，用
pipeline或 Lua 脚本保证写入+过期的原子性（尤其高并发场景） - 如果会话需要“滑动过期”（每次访问重置 TTL），记得在每次
HGet后补调一次Expire
微服务间共享会话时的 Key 设计与冲突预防
Key 名不能只用 session:{id}，得带上服务标识或租户上下文，否则不同服务写同一 key 会互相覆盖：
- 推荐格式：
session:{service_name}:{tenant_id}:{session_id}，例如session:order-svc:org_42:abc123 - 避免使用用户输入直接拼接 key，防止注入（如
session: + userID）；应校验session_id是否符合 UUID 格式 - 如果服务部署多实例，确保 Redis 连接复用同一个
redis.Client实例，而非每个请求新建 client —— 否则连接池耗尽、超时频发 - 生产环境建议开启 Redis 的
READONLY模式保护主库，读操作走 replica，写操作走 master
Hash 结构本身很轻量，但字段膨胀（比如存了 50+ 个元数据）会让 HGetAll 带宽压力变大；真要存大量上下文，考虑把冷字段拆到另一个 key，或改用 JSON 字段压缩后存在 Hash 的一个值里。
