memcached.dial 连接失败主因是服务未启动或协议不匹配：本地需启动memcached并用telnet测试端口，docker注意网络可达性，连接字符串须为"127.0.0.1:11211"而非url格式。
memcached.Dial 连接失败的常见原因
Go 项目里 memcached.Dial 报错，十有八九不是代码写错了，而是服务没通或协议不匹配。
- 本地没起
memcached？用telnet 127.0.0.1:11211测试端口是否可连；Mac 用户注意：Homebrew 装完默认不自动启动，得手动brew services start memcached - 连接字符串写成
"tcp://127.0.0.1:11211"是错的——gomemcache的Dial只接受地址，不支持 URL scheme，直接传"127.0.0.1:11211" - 如果用 Docker，别只 expose 端口，还要确认容器网络能被 Go 进程访问；Docker for Mac 上
localhost不等于容器内host.docker.internal
Set 和 Get 的 key/value 类型限制
gomemcache 的 Set 和 Get 只认 []byte，不会自动序列化。传 struct 或 string 不报错，但读出来是乱码或空值。
- 必须手动序列化：JSON 最常用，用
json.Marshal写入，json.Unmarshal读出 - key 必须是纯 ASCII 字符串，含空格、控制符、非打印字符（比如
\x00）会静默失败——Set返回 nil error，但实际没存进去 - value 大小建议控制在 1MB 以内；超过后 Memcached 会截断，且不提示，
Get返回的Item.Value长度变短就是信号
缓存未命中时的 nil panic 风险
mc.Get("user:123") 没查到 key，返回 (*memcache.Item)(nil)，直接取 .Value 就 panic。
- 永远先判空：
if item == nil { /* 缓存未命中 */ } - 别依赖
err != nil判断是否命中——缓存未命中时err是nil，只有网络或协议错误才带 error - 想统一处理未命中逻辑？封装一层，比如
GetJSON(key string, v interface{}) error，内部做判空 + 反序列化
超时与重试配置的实际影响
memcache.Client 默认没有超时，一次卡住就拖垮整个 HTTP 请求；也默认不重试，网络抖动会导致瞬间大量缓存穿透。
立即学习“go语言免费学习笔记（深入）”；
- 设置
Timeout：创建 client 后立刻赋值，mc.Timeout = 100 * time.Millisecond，别信“默认 1s”——源码里是 0，即无限等待 - 重试要自己加：库本身不重试，需在外层包一层，比如用
for i := 0; i + <code>time.Sleep，但注意别把重试逻辑塞进Get里，否则并发高时放大压力 - 连接池大小默认是 1，QPS 上去后容易阻塞；用
mc.MaxIdleConns = 10提前调大，但别设太高，Memcached 单实例连接数有限制（默认 1024）
真正麻烦的不是怎么写那几行 Set/Get，而是 key 命名要不要加前缀、过期时间该设 5 分钟还是 2 小时、JSON 序列化要不要忽略空字段——这些没法靠库解决，得看业务数据更新频率和一致性要求。
