GolangMemcached缓存使用教程

本文深入剖析了在 Go 语言中使用 gomemcache 连接和操作 Memcached 的实战要点与常见陷阱：从连接失败（如 connection refused、超时）的根源排查——服务未启动、地址格式错误（必须用 IP+端口而非 localhost）、Docker 网络配置不当，到数据存取异常（Get 返回 nil）的关键原因——key 非 ASCII、value 未序列化为 []byte、过期时间单位误用为毫秒；同时强调高并发下的最佳实践，包括显式设置超时、避免 client 复用老化、合理分批调用 GetMulti，并明确推荐官方维护的 github.com/bradfitz/gomemcache/memcache 而非已废弃的替代库，最后点明 Memcached 本质是无持久化、无复杂查询的轻量级字节缓存，所有业务级容错（如缓存穿透、雪崩）都需 Go 层自主实现——这是一份直击生产痛点、拒绝纸上谈兵的硬核避坑指南。

连接 Memcached 服务经常超时或报 connection refused

多数情况不是代码写错了，而是本地没起 Memcached 实例，或者客户端连了错误地址。gomemcache 默认不自动重连，首次 Set 或 Get 时才真正建连，所以错误常在运行时暴露。

• 确认服务已启动：memcached -p 11211 -m 64（Mac/Linux），Windows 需单独下载二进制并运行
• 检查地址格式：gomemcache 要求传入 []string，比如 []string{"127.0.0.1:11211"}，不能漏掉端口，也不能写成 "localhost:11211"（DNS 解析慢且不可靠）
• 防火墙/容器网络：Docker 启动的 Memcached 要用 host.docker.internal（Mac/Win）或宿主机 IP（Linux），别直接写 127.0.0.1

mc.Set() 成功但 mc.Get() 返回空或 nil

不是缓存没存进去，而是 key 冲突、过期、或类型没对上。gomemcache 对 value 只认 []byte，其他类型得自己序列化。

• key 必须是 ASCII 字符串，含空格、中文、控制字符会静默失败（Get 返回 nil，无错误）
• value 必须是 []byte：传 string 要转 []byte(s)；传 struct 得先 json.Marshal，取回再 json.Unmarshal
• 过期时间单位是秒，不是毫秒：mc.Set(&memcache.Item{Key: "user:123", Value: []byte("ok"), Expiration: 300}) 表示 5 分钟

并发写入时出现 memcache: server error 或 key 丢失

gomemcache 本身是线程安全的，但默认单 client 实例共享底层 TCP 连接池。高并发下若没设好连接数或超时，容易打满连接或触发服务端限流。

• 显式设置超时：mc := memcache.New(servers...); mc.Timeout = 500 * time.Millisecond
• 避免复用过老的 client：长期运行的服务建议定期重建 *memcache.Client，尤其在服务重启、网络抖动后
• 批量操作慎用：GetMulti 是并发请求，但 key 数量超过 100 容易被 Memcached 拒绝（默认 max item size + 协议开销限制），拆成多批更稳

用 gomemcache 还是 go-memcache？

现在主流只用 github.com/bradfitz/gomemcache/memcache（即 gomemcache），另一个 go-memcache 已多年未维护，不支持 SASL 认证、无连接池配置、Get 返回值接口也不兼容。

• 安装命令必须是：go get github.com/bradfitz/gomemcache/memcache
• 注意 import 路径结尾是 /memcache，不是根目录
• 如果项目用了 Go Module，检查 go.sum 里是否锁定了 v0.0.0- 开头的伪版本——那是没打 tag 的 commit，建议指定明确 commit 或等官方发版

Memcached 不保证数据持久，也不支持复杂查询，它只是个带过期的字节桶。所有“缓存穿透”“缓存雪崩”的应对逻辑，都得在 Go 层自己加，库不会替你兜底。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。