在go-zero框架中对接redis缓存,核心步骤是配置连接参数并在代码中实例化 redis.new 对象。具体做法是在 etc/config.yaml 中定义 redis 节点信息,然后在服务逻辑中通过依赖注入获取该实例,调用其 set 或 get 方法即可完成数据读写。

如何配置Redis连接参数
需要在 etc/config.yaml 文件中添加 Redis 字段,指定主机地址、端口及密码。Go-Zero 的 core/redis 模块会自动解析这些配置项。

package main
import (
"context"
"fmt"
"log"
"github.com/zeromicro/go-zero/core/stores/redis"
"github.com/zeromicro/go-zero/core/conf"
)
type Config struct {
Redis redis.RedisConf `json:",plain"`
}
func main() {
var c Config
conf.MustLoad("config.yaml", &c)
// 创建 Redis 客户端实例
r := redis.New(c.Redis.Host, redis.WithPassword(c.Redis.Password))
ctx := context.Background()
key := "user:1001"
value := "{"name":"Alice","age":30}"
// 设置缓存,过期时间5分钟
err := r.Set(key, value, 300)
if err != nil {
log.Fatalf("set failed: %v", err)
}
// 获取缓存
val, err := r.Get(key)
if err != nil {
log.Fatalf("get failed: %v", err)
}
fmt.Printf("Retrieved value: %s\n", val)
}
如何在业务逻辑中使用缓存
在具体的 RPC 或 HTTP Handler 中,将 redis.Client 作为结构体字段注入。查询时先尝试从 Redis 获取,若命中则直接返回;若未命中(Miss),则查询数据库并回填缓存,同时设置合理的过期时间以防止脏读。

// UserStore 示例结构体
type UserStore struct {
db *sql.DB
cache *redis.RedisConn
}
func (u *UserStore) GetUser(id string) (*User, error) {
// 1. 尝试从缓存获取
val, err := u.cache.Get(fmt.Sprintf("user:%s", id))
if err == nil {
// 缓存命中,反序列化并返回
var user User
json.Unmarshal([]byte(val), &user)
return &user, nil
}
// 2. 缓存未命中,查询数据库
var user User
row := u.db.QueryRow("SELECT name, age FROM users WHERE id = ?", id)
err = row.Scan(&user.Name, &user.Age)
if err != nil {
return nil, err
}
// 3. 写入缓存
data, _ := json.Marshal(user)
u.cache.Set(fmt.Sprintf("user:%s", id), string(data), 600)
return &user, nil
}
当Redis连接断开时会发生什么
如果 Redis 服务不可用,Set 和 Get 方法会立即返回错误,例如 connection refused 或 timeout。Go-Zero 的 redis 包默认不会自动重试,开发者必须在业务层捕获这些错误,决定是直接降级返回空值、查询数据库还是抛出全局异常。建议在初始化时配置 WithDialTimeout 和 WithReadTimeout 以控制等待时间,避免请求长时间挂起。











