Go项目连接Redis应使用github.com/redis/go-redis/v9,需传*redis.Options并设Addr、ContextTimeout等,复用全局client;Memcached用github.com/bradfitz/gomemcache/memcache,value须[]byte且无内置序列化;二者选型取决于数据结构、过期策略及扩展需求;务必设置context超时并调用cancel()防goroutine泄漏。

Go 项目中连接 Redis 的标准方式
Go 生态里最主流的 Redis 客户端是 github.com/redis/go-redis/v9(v9 是当前稳定版),它基于 context 支持取消和超时,比老版本 github.com/go-redis/redis 更符合现代 Go 实践。
安装命令:
go get github.com/redis/go-redis/v9
- 初始化客户端必须传入
*redis.Options,其中Addr是必填项(如"localhost:6379"),不填会 panic - 建议显式设置
ContextTimeout和ReadTimeout,避免网络抖动导致 goroutine 卡死 - 连接池配置通过
PoolSize控制,默认 10,高并发场景下需根据 QPS 和平均响应时间调优(例如 20–50) - 不要在每次操作都新建 client,应全局复用一个
*redis.Client实例
用 Go 操作 Memcached 的最小可行方案
Memcached 在 Go 中没有官方客户端,但 github.com/bradfitz/gomemcache/memcache 是事实标准,轻量、无依赖、API 简洁。
安装命令:
go get github.com/bradfitz/gomemcache/memcache
立即学习“go语言免费学习笔记(深入)”;
- 初始化只需传入服务器地址切片,例如
[]string{"127.0.0.1:11211"};支持多个节点,但客户端不自动做一致性哈希,需自行封装 - 所有方法(
Set、Get)都返回error,且Get找不到 key 时返回memcache.ErrCacheMiss,不是 nil error —— 这点常被误判为异常 - value 必须是
[]byte,存结构体前要手动json.Marshal,取回后json.Unmarshal,没有内置序列化 - 不支持 pipeline 或事务,单次操作即一次 TCP 请求,批量读写需自己循环 + 并发控制
Redis vs Memcached:选型时的关键差异点
不是“哪个更好”,而是“哪个更匹配当前需求”。真实项目里踩过坑的点集中在数据结构、过期策略和扩展性上。
- Redis 支持 list/set/zset/hash 等丰富类型,适合做排行榜、队列、布隆过滤器;Memcached 只支持 string,纯 KV
- Redis 过期是被动+主动混合清理,key 可能短暂残留;Memcached 过期是惰性删除(访问时才检查),内存占用更可控
- Redis 持久化可选 RDB/AOF,Memcached 全内存,宕机即丢数据 —— 如果业务不能容忍丢失,Memcached 必须配双写或降级逻辑
- 横向扩展:Redis Cluster 原生支持分片,Memcached 需靠客户端分片(如 ketama),扩容时 key 分布重算,缓存击穿风险更高
常见错误:context 超时未设置导致请求卡死
这是 Go 服务接入缓存后最隐蔽的稳定性问题。Redis/Memcached 客户端默认不设超时,一旦下游网络阻塞或服务假死,goroutine 就永远 hang 住,最终耗尽连接数或 goroutine 数。
- Redis 示例中必须用带 context 的方法,比如
client.Get(ctx, "key").Result(),而不是client.Get("key").Result() - ctx 应来自 HTTP request context 或自建带 timeout 的 context:
ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond) defer cancel()
- Memcached 同样需传入 context(v0.0.7+ 支持),调用
mc.Get(ctx, "key");旧版本无 context 支持,必须升级或换库 - 别忽略
cancel()调用 —— 漏掉会导致 ctx 泄露,长时间运行服务内存缓慢上涨
缓存集成真正难的不是连上,而是让失败可预期、超时可收敛、扩容不影响命中率。这些细节没压到代码里,再好的架构也会在线上出问题。
