// Package cache Redis 缓存客户端封装(go-redis/v9,Day 6)。 // 统一 single / cluster / sentinel 三种模式的客户端构造与生命周期, // 业务侧通过嵌入的 redis.UniversalClient 使用全部 Redis 命令。 package cache import ( "errors" "fmt" "strings" "time" "github.com/redis/go-redis/v9" ) // Mode 常量:Redis 部署模式。 const ( ModeSingle = "single" ModeCluster = "cluster" ModeSentinel = "sentinel" ) // Options Redis 客户端配置(对应 config.Redis)。 type Options struct { Mode string // single | cluster | sentinel Addrs []string Password string DB int // 仅 single/sentinel 有效 PoolSize int MasterName string // 仅 sentinel 有效 } // Client 统一 Redis 客户端;嵌入 UniversalClient, // 单机与集群命令签名一致(Set/Get/Del/Eval/Pipeline 等)。 type Client struct { redis.UniversalClient mode string } // Mode 返回部署模式。 func (c *Client) Mode() string { return c.mode } // New 按模式构造 Redis 客户端(lazy 连接,首次命令时建立连接)。 func New(opt Options) (*Client, error) { mode := strings.ToLower(strings.TrimSpace(opt.Mode)) if mode == "" { mode = ModeSingle } if len(opt.Addrs) == 0 { return nil, errors.New("redis.addrs 不能为空") } if opt.PoolSize <= 0 { opt.PoolSize = 100 } var uc redis.UniversalClient switch mode { case ModeSingle: uc = redis.NewClient(&redis.Options{ Addr: opt.Addrs[0], Password: opt.Password, DB: opt.DB, PoolSize: opt.PoolSize, DialTimeout: dialTimeout, ReadTimeout: readTimeout, WriteTimeout: writeTimeout, }) case ModeCluster: uc = redis.NewClusterClient(&redis.ClusterOptions{ Addrs: opt.Addrs, Password: opt.Password, PoolSize: opt.PoolSize, DialTimeout: dialTimeout, ReadTimeout: readTimeout, WriteTimeout: writeTimeout, }) case ModeSentinel: if opt.MasterName == "" { return nil, errors.New("sentinel 模式必须配置 master_name") } uc = redis.NewFailoverClient(&redis.FailoverOptions{ MasterName: opt.MasterName, SentinelAddrs: opt.Addrs, Password: opt.Password, DB: opt.DB, PoolSize: opt.PoolSize, DialTimeout: dialTimeout, ReadTimeout: readTimeout, WriteTimeout: writeTimeout, }) default: return nil, fmt.Errorf("未知 redis 模式: %q(可选 single/cluster/sentinel)", opt.Mode) } return &Client{UniversalClient: uc, mode: mode}, nil } // Ping 连通性检查直接使用嵌入的 UniversalClient.Ping(返回 *redis.StatusCmd), // 例如:if err := c.Ping(ctx).Err(); err != nil { ... }。 // 超时常量(连接建立与命令 IO)。 const ( dialTimeout = 3 * time.Second readTimeout = 1 * time.Second writeTimeout = 1 * time.Second )