Golang 操作 Redis：连接设置与参数详解 - go-redis 使用指南

在上一篇《Golang 操作 Redis：快速上手 - go-redis 使用指南》文章中，我们介绍了如何初始化 go-redis 客户端并进行了基本的 Redis 操作。本文将深入探讨 go-redis 的连接设置与参数配置，帮助你在实际项目中更好地使用 go-redis。

👉 点击查看 go-redis 使用指南目录

在《go-redis 使用指南》系列文章中，我们将详细介绍如何在 Golang 项目中使用 redis/go-redis 库与 Redis 进行交互。以下是该系列文章的全部内容：

初始化 go-redis 客户端

在使用 go-redis 前，需要初始化一个 Redis 客户端。除了基础的地址和数据库编号，go-redis 提供了许多配置参数来优化连接。以下是一个详细的初始化示例：

package main

import (
    "context"
    "fmt"
    "time"
    "github.com/redis/go-redis/v9"
)

var ctx = context.Background()

func main() {
    rdb := redis.NewClient(&redis.Options{
        Addr:         "localhost:6379", // Redis 服务器地址
        Password:     "",               // 没有密码则留空
        DB:           0,                // 使用默认数据库
        PoolSize:     10,               // 连接池大小
        MinIdleConns: 3,                // 最小空闲连接数
        DialTimeout:  5 * time.Second,  // 连接超时时间
        ReadTimeout:  3 * time.Second,  // 读超时时间
        WriteTimeout: 3 * time.Second,  // 写超时时间
    })

    // 测试连接
    pong, err := rdb.Ping(ctx).Result()
    if err != nil {
        fmt.Println("无法连接到 Redis:", err)
        return
    }
    fmt.Println("连接成功:", pong)
}

go-redis 客户端连接设置详解

Addr

Addr 参数指定 Redis 服务器的地址，通常是 IP 地址和端口号的组合。例如：localhost:6379。

Password

Password 参数用于指定连接 Redis 服务器的密码。如果 Redis 服务器未设置密码，此处可以留空。

DB

DB 参数用于指定连接的数据库编号。Redis 默认有 16 个数据库，编号从 0 到 15。默认情况下使用 0 号数据库。

PoolSize

PoolSize 参数用于设置连接池的大小。合理配置连接池大小可以提高并发处理能力，默认值为 10。

MinIdleConns

MinIdleConns 参数用于设置连接池中最小的空闲连接数。保持一定数量的空闲连接可以减少连接建立的开销，提升性能。

DialTimeout

DialTimeout 参数用于设置连接超时时间。当连接 Redis 服务器时间超过此值时会报错。默认值为 5 秒。

ReadTimeout

ReadTimeout 参数用于设置读操作的超时时间。默认值为 3 秒。如果在此时间内未能读取到数据，将会报错。

WriteTimeout

WriteTimeout 参数用于设置写操作的超时时间。默认值为 3 秒。如果在此时间内未能写入数据，将会报错。

go-redis 客户端高级连接配置

在某些场景下，你可能需要更加高级的连接配置。以下是一些常用的高级配置参数：

MaxRetries

MaxRetries 参数用于设置命令执行失败时的最大重试次数。默认值为 3。

rdb := redis.NewClient(&redis.Options{
    Addr:       "localhost:6379",
    MaxRetries: 5,
})

MinRetryBackoff 和 MaxRetryBackoff

MinRetryBackoff 和 MaxRetryBackoff 参数用于设置命令重试的最小和最大退避时间。默认值分别为 8 毫秒和 512 毫秒。

rdb := redis.NewClient(&redis.Options{
    Addr:            "localhost:6379",
    MinRetryBackoff: 1 * time.Second,
    MaxRetryBackoff: 5 * time.Second,
})

PoolTimeout

PoolTimeout 参数用于设置当连接池已满时，获取连接的最大等待时间。默认值为 4 秒。

rdb := redis.NewClient(&redis.Options{
    Addr:        "localhost:6379",
    PoolTimeout: 10 * time.Second,
})

IdleTimeout

IdleTimeout 参数用于设置连接空闲超过指定时间后关闭连接。默认值为 5 分钟。

rdb := redis.NewClient(&redis.Options{
    Addr:        "localhost:6379",
    IdleTimeout: 10 * time.Minute,
})

TLS 配置

如果你的 Redis 服务器启用了 TLS/SSL，加密通信可以通过配置 TLSConfig 参数来实现。

import (
    "crypto/tls"
    "github.com/redis/go-redis/v9"
)

rdb := redis.NewClient(&redis.Options{
    Addr:      "localhost:6379",
    TLSConfig: &tls.Config{
        InsecureSkipVerify: true, // 如果使用自签名证书，可以设置为 true
    },
})