Gin框架基本集成Redis-Golang-PHP中文网

应全局单例初始化redis.client，使用redis.newclient()创建一次并赋值包级变量，所有操作必须传c.request.context()，显式设置read/writetimeout，正确区分redis.nil（业务逻辑）与真实error，并暴露poolstats供观测。

gin框架基本集成redis

直接用 go-redis/v8 初始化，别手写连接池或复用 net.Conn。关键不是“连上”，而是“连得稳、用得对”。
常见错误是把 redis.Client 当局部变量传进 handler，结果每次请求都新建连接，很快耗尽文件描述符。

正确做法是全局单例 + context 透传：

在 main() 或 bootstrap/redis.go 中调用 redis.NewClient() 创建一次，赋值给包级变量（如 var RDB *redis.Client）
所有操作必须带 context.Context，推荐用 c.Request.Context() 而非全局 context.Background()，避免超时传递失效
务必调用 RDB.Ping(ctx).Err() 检查连接，失败时 panic 或 log 后 exit，不要静默忽略
如果用配置文件（如 viper），地址、密码、DB 号要从配置读，别硬编码 "localhost:6379"

redis.Nil 是正常响应，表示 key 不存在 —— 它不是 error，但容易被当成 error 处理，导致接口返回 500。

典型误用：

val, err := rdb.Get(ctx, "user:123").Result()
if err != nil {
    c.JSON(500, gin.H{"error": err.Error()})
    return
}

这段代码会让 key 不存在时也返回 500。正确处理方式：

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

先判断 err == redis.Nil：这是业务逻辑分支，应返回 404 或空数据
再判断其他 err（如网络中断、超时）：这才是真错误，才该返回 500
用 result, err := rdb.Get(ctx, key).Result() 后，优先检查 err 类型，而不是直接 if err != nil

Redis 默认是同步阻塞调用，但 go-redis/v8 所有方法都支持 context 控制超时，不设 timeout 就可能卡死 goroutine。

必须显式设置：

在 redis.Options 里配 ReadTimeout 和 WriteTimeout（例如 5 * time.Second）
每次调用前构造带 timeout 的 ctx：ctx, cancel := context.WithTimeout(c.Request.Context(), 3*time.Second)，并在 defer 中 cancel()
别依赖服务端 timeout 配置（如 redis.conf 的 timeout），那是空闲连接关闭时间，不影响单次命令
高并发场景下，考虑用 WithContext() 替代直接传 ctx，避免中间件修改 context 导致取消信号丢失