memcached 连接超时或 connection refused 多因未启动服务或地址错误；gomemcache 不自动重连，需检查实例、地址格式（如 []string{"127.0.0.1:11211"}）、防火墙及容器网络配置。
连接 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语言免费学习笔记（深入）”；
- 安装命令必须是：
go get github.com/bradfitz/gomemcache/memcache - 注意 import 路径结尾是
/memcache，不是根目录 - 如果项目用了 Go Module，检查
go.sum里是否锁定了 v0.0.0- 开头的伪版本——那是没打 tag 的 commit，建议指定明确 commit 或等官方发版
Memcached 不保证数据持久，也不支持复杂查询，它只是个带过期的字节桶。所有“缓存穿透”“缓存雪崩”的应对逻辑，都得在 Go 层自己加，库不会替你兜底。
