必须显式配置PoolSize(20–50)、MinIdleConns(≥5)、MaxConnAge(30分钟),初始化后用带超时ctx调Ping验证连通性,所有操作须用context.WithTimeout,键加服务前缀且结构体序列化统一用json。

直接用 redis.NewClient() 初始化后往 Fiber handler 里塞 client.Get(),线上压测大概率触发 redis: connection pool timeout 或 goroutine 卡死——这不是 Redis 慢,是 Go 层连接池、超时、键设计三处没兜住。
redis.NewClient 必须显式配 PoolSize 和 Ping 验证连通性
默认 PoolSize=10、MinIdleConns=0,QPS 超 200 就开始排队;冷启动时若空闲连接被 SLB 静默断开,第一个请求必重连失败。
-
PoolSize设为 20–50:低于 20 容易阻塞;高于 50 可能打满 Redis 的maxclients(单实例建议 ≤5000) -
MinIdleConns必须 ≥5:防 NAT/SLB 断连后首请求 hang 住 - 初始化后立刻用带超时的
ctx调rdb.Ping(ctx).Err(),别等第一个Get才暴露地址错、密码错或网络不通 - 地址、密码、DB 从环境变量读,比如
os.Getenv("REDIS_ADDR"),硬编码"localhost:6379"在容器/K8s 下必炸
所有 Redis 操作必须带 context.WithTimeout,禁用 context.Background
在 Fiber handler 里传 context.Background() 给 client.Get(),等于把请求生命周期交给 Redis 响应时间——它卡 2 秒,你的 handler 就卡 2 秒,监控看到的是 goroutine 数暴涨、QPS 断崖下跌。
- HTTP handler 中统一用:
ctx, cancel := context.WithTimeout(c.Context(), 300*time.Millisecond),用完记得defer cancel() - 写操作(
Set、Del、分布式锁)同样要超时;锁逻辑缺超时,会导致后续请求永久等待 - 绝不在
init()或包级变量里声明ctx = context.Background()——它没有取消信号,不是“默认”,是“永生”
缓存键必须加服务前缀,结构体序列化方式需全局统一
多个服务共用一个 Redis 实例但没前缀,或同一结构体在不同模块混用 json.Marshal 和 gob.Encode,结果就是读出来 invalid character 或直接 panic,日志里搜不到源头。
立即学习“go语言免费学习笔记(深入)”;
- key 推荐格式:
"user-service:user:123"、"order-service:order:20261103",前缀明确业务域 - 结构体字段必须导出 + 显式
json:"field_name"tag,存取都走json.Marshal/json.Unmarshal - 拼 key 时避免裸接用户输入,先做
strings.ReplaceAll(username, ":", "_")或url.PathEscape() - 禁止用
gob:跨语言/版本不兼容,二进制不可读,debug 和监控全失效
Fiber handler 中怎么安全读写缓存(Cache-Aside 模式)
穿透/击穿/雪崩不是 Redis 自身能解决的问题,必须在 Go 层加轻量兜底策略。布隆过滤器太重,多数场景用这几行代码更稳。
- 穿透:查 DB 返回空时,存
rdb.Set(ctx, key, "null", 60*time.Second);业务解包前先判if val == "null" { return nil, nil } - 击穿:热点 key 过期瞬间大量请求打穿 DB,用
singleflight.Group包一层Do(),同一 key 的并发请求只放行一个去查 DB - 雪崩:避免所有 key 同一时刻过期,TTL 加随机扰动:
baseTTL + time.Duration(rand.Int63n(int64(2*time.Minute))) - 别设
TTL=0:rdb.Set(ctx, key, val, 0)表示“不设置过期”,不是“永不过期”,Redis 会立即删掉 key
最常被忽略的是:连接池参数和超时控制必须在启动阶段就配好,而不是等报错再补;键前缀和序列化方式一旦上线就难改,初期就得定死。缓存不是加个 Get 就完事,而是从初始化那一刻起,每一步都在决定线上是否稳定。


















