Fiber集成Redis需手动配置客户端，禁止在handler中新建client；应于main()中初始化带合理连接池参数的client，通过中间件注入ctx，所有操作须传带超时的context并校验redis.Nil。
Fiber 本身不内置 Redis 支持，连接 Redis 完全依赖你选的客户端库（如 github.com/redis/go-redis/v9）和手动集成方式。直接在 Fiber 的 app.Get() 或中间件里 new 一个 client 是常见错误——会导致连接泄漏、超时失控、上下文未传播。
初始化 Redis client 必须绑定 Fiber 的生命周期管理
不能在 handler 里每次 new client，也不能在 init() 里用 context.Background() 初始化。正确做法是：在 main() 启动 Fiber 前完成 client 构建，并通过 app.Use() 或自定义中间件注入到请求上下文。
- 用
redis.NewClient()创建 client 时，必须显式配置PoolSize（建议 20–50）、MinIdleConns（≥5）、ConnMaxIdleTime（如 5 * time.Minute） - 初始化后立即调用
rdb.Ping(ctx).Err()验证连通性；失败就 panic，别等第一个请求才暴露问题 - 把 client 存进
fiber.Ctx.Locals或全局变量（推荐前者），避免多 goroutine 竞争或误复用 - 不要在中间件里做
rdb.Set()这类写操作——除非你明确需要缓存响应，否则应只读或交由业务层决定
在 Fiber handler 中安全使用 Redis 操作
所有 rdb.Get()、rdb.HGetAll() 等调用都必须传入带超时的 context.Context，且该 context 应来自 c.Context()（Fiber 的 Ctx 实现了 context.Context 接口）。
- HTTP handler 内统一用：
ctx, cancel := context.WithTimeout(c.Context(), 300*time.Millisecond)，然后 defer cancel() - 禁止传
context.Background()或nil，否则会 panic 报context must be non-nil - 读取 key 为空时检查
errors.Is(err, redis.Nil)，不是err == nil—— Redis 返回空值不等于操作失败 - 结构体序列化统一走
json.Marshal/json.Unmarshal，字段加json:"field"tag，避免 gob/json 混用导致 panic
Docker 环境下 Fiber 连 Redis 的地址陷阱
当 Fiber 应用跑在 Docker 容器里，而 Redis 在宿主机或另一容器时，localhost:6379 一定不通——它指向容器自身，不是你的 Mac/Windows/Linux 主机。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- Mac / Windows：Redis 地址改用
host.docker.internal:6379 - Linux（Docker 默认 bridge）：用
172.17.0.1:6379（查ip route | awk '/default/ { print $3 }'更准） - 两个服务都在同一 docker-compose.yml 中：直接用 service 名，如
redis:6379 - 远程 Redis（如阿里云、腾讯云）：确认
bind配置为0.0.0.0，且protected-mode no（仅测试），生产环境必须配密码 + ACL
缓存穿透/击穿必须在 Fiber 层兜底
Redis 自身不处理穿透或击穿，Fiber handler 是最后一道防线。靠 SET key "null" EX 60 或 singleflight.Group 包一层 Do 是最低成本方案。
- 穿透：DB 查无结果时，
rdb.Set(ctx, key, "null", 60*time.Second)，后续解包前判if val == "null" { return nil, nil } - 击穿：热点 key 过期瞬间大量请求打穿 DB，用
singleflight.Group.Do(key, fn)确保同一 key 只有一个请求落库 - 雪崩：避免所有 key 同一时间过期，设置随机 TTL 偏移（如
baseTTL + rand.Intn(60)） - 键名必须加前缀，如
user:profile:123，防止多服务共用实例时互相污染
连接池参数没设对、context 超时不传、Docker 地址写死 localhost、缓存空值不处理——这四点线上最常引发 redis: connection pool timeout 或 goroutine 卡死，比 Redis 本身慢更致命。
