必须显式安装 github.com/redis/go-redis/v9（含/v9后缀），因其是唯一活跃且支持context的版本；社区封装包如fiber-redis已过时、不兼容v9接口，且违背Fiber中间件设计哲学；Redis客户端需在main中初始化并健康检查，生命周期须与app对齐，操作时必须传入带超时的context。
直接用 go get github.com/gofiber/fiber/v2 安装 Fiber，但 Redis 依赖不能只装一个包——必须显式引入 github.com/redis/go-redis/v9，且版本号不能省略。
为什么不能用 “Fiber-Redis” 这类封装包
所谓 fiber-redis 或 fiber-redis-middleware 多是过时的社区封装，把 *redis.Client 塞进 c.Locals 会加重 GC 压力，也不符合 Fiber 的中间件设计哲学。Fiber 本身不内置任何数据库支持，Redis 集成完全由你选的客户端库（go-redis/v9）和初始化方式决定。
常见错误：执行 go get github.com/gofiber/fiber-redis 后发现 import 报错、类型不匹配、或 rdb.Set() 方法不存在——因为那包早已停止维护，且未适配 v9 的 context-first 接口。
- 必须用
go get github.com/redis/go-redis/v9，v9是当前唯一活跃、支持超时控制和context.Context的版本 - 别漏掉
/v9后缀，否则可能拉到 v8（已弃用）甚至 v7（无 context 支持） - Fiber v2 和 redis-go/v9 没有强耦合，不需要“适配包”，只需手动传 client 实例
安装后第一步：验证能否连上 Redis
别等第一个请求才暴露连接失败。在 main() 初始化 Fiber app 之前，就该完成 Redis client 构建并做健康检查。
示例关键片段：
import (
"context"
"log"
"time"
"github.com/gofiber/fiber/v2"
"github.com/redis/go-redis/v9"
)
<p>func main() {
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // 注意：若 Redis 有密码，这里不能为空字符串
DB: 0,
PoolSize: 30, // 建议 20–50
MinIdleConns: 5, // 避免冷启动慢
ConnMaxIdleTime: 5 * time.Minute,
})</p><pre class="brush:php;toolbar:false;">ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
if err := rdb.Ping(ctx).Err(); err != nil {
log.Fatal("failed to connect to Redis:", err) // panic 不如 log.Fatal + os.Exit(1)
}
app := fiber.New()
// …后续注册路由、中间件
}
-
Password: ""在无认证 Redis 下合法；但若配置了 requirepass，空字符串会导致 AUTH 失败 -
Ping()必须传带超时的context.Context，不能用context.Background()，否则测试环境卡住不报错 - 失败时不 recover、不忽略，直接
log.Fatal—— 带病启动比启动失败更危险
接入后怎么在 handler 里安全读写
所有 Redis 操作必须走同一个 client 实例，并传入来自 c.Context() 的 context，不能闭包捕获全局变量再裸调 rdb.Get("key")。
正确姿势是：把 *redis.Client 存进 c.Locals，或更推荐——直接闭包捕获 rdb 变量（因为它是线程安全的）。
示例 handler：
app.Get("/user/:id", func(c *fiber.Ctx) error {
ctx, cancel := context.WithTimeout(c.Context(), 300*time.Millisecond)
defer cancel()
<pre class="brush:php;toolbar:false;">key := "user:" + c.Params("id")
val, err := rdb.Get(ctx, key).Result()
if err == redis.Nil {
return c.Status(404).SendString("not found")
} else if err != nil {
return c.Status(500).SendString("redis error")
}
return c.SendString(val)
})
-
err == redis.Nil是空值，不是错误；必须用errors.Is(err, redis.Nil)判断（redis.Nil是一个预定义错误变量） -
context.WithTimeout(c.Context(), ...)是必须步骤，300ms 是常见缓存读取上限，超时后自动 cancel - 别在 handler 里 new
redis.Client，哪怕只调一次——连接池无法复用，很快耗尽 fd
最易被忽略的一点：Redis client 的生命周期必须与 Fiber app 对齐。它不是“用的时候 new，不用就丢”，而是“启动时建好，退出时 Close()”。如果你用 systemd 或 k8s 管理进程，记得在 os.Interrupt 信号里调 rdb.Close()，否则可能残留连接导致 Redis 服务端连接数爆满。
