beego.NewCache("memcache", config) 初始化失败典型表现为返回nil，后续Put/Get panic或返回空值；主因是未下划线导入memcache驱动包，且配置字段名必须为"conn"、不可多字段或空格。
beego.NewCache("memcache", config) 初始化失败的典型表现
调用 cache.NewCache("memcache", config) 后返回 nil，后续调用 Put 或 Get 直接 panic，或者始终返回空值、无错误提示——这是最常见也最隐蔽的问题。
根本原因不是配置写错，而是驱动未注册。Beego 的 cache 模块依赖显式导入才能激活对应后端，memcache 驱动必须通过下划线导入：
import (
"github.com/astaxie/beego/cache"
_ "github.com/astaxie/beego/cache/memcache" // 必须！不能省略下划线
)漏掉这行，NewCache 就不会识别 "memcache" 类型，静默 fallback 到 nil。其他驱动（如 redis）同理。
memcache 配置字符串格式必须严格匹配 vitess/memcache 驱动要求
Beego 的 memcache 驱动底层用的是 vitess 的实现，它只认一个字段：conn，且必须是 JSON 字符串形式。常见错误包括：
立即学习“go语言免费学习笔记（深入）”；
- 写成
{"address": "127.0.0.1:11211"}→ 错，字段名必须是"conn" - 写成
{"conn": "127.0.0.1:11211", "timeout": 500}→ 错，vitess 驱动不支持额外字段，会解析失败 - 写成
{"conn":"127.0.0.1:11211 "}→ 错，末尾空格导致 JSON 解析失败
正确写法只有一条：
config := `{"conn":"127.0.0.1:11211"}`多个节点用逗号分隔：{"conn":"10.0.1.10:11211,10.0.1.11:11211"}。不支持用户名、密码、超时等扩展参数。
Revel 和 beego 的 memcache 配置差异：别混用
如果你在迁移或对比框架，注意 Revel 的 memcache 配置走的是 app.conf 文件，字段是 cache.memcached.servers；而 beego 完全不读配置文件，全靠代码里传入的 JSON 字符串。两者驱动不同、解析逻辑不同、错误反馈方式也不同。
常见踩坑点：
- 把 Revel 的配置格式（如
cache.memcached.timeout = 500）直接套到 beego 的config字符串里 → 解析失败 - 以为 beego 支持
connectTimeout或retry参数 → 实际不支持，这些由底层vitess库默认处理，不可控 - 本地开发用
127.0.0.1，上线后没改地址 → 连不上生产 Memcached，但无报错，缓存失效静默发生
替代方案：用 gomemcache 直接操作更可控
当 beego 的 memcache 驱动无法满足需求（比如需要自定义超时、重试策略、健康检查、或对接非标准端口），建议绕过 cache 模块，直接用原生客户端：
import "github.com/bradfitz/gomemcache/memcache"
<p>mc := memcache.New("10.0.1.20:11211")
mc.Timeout = 300 * time.Millisecond
mc.MaxIdleConns = 10</p><p>item := &memcache.Item{
Key: "user:1001",
Value: []byte(<code>{"id":1001,"name":"alice"}</code>),
Expiration: 3600,
}
err := mc.Set(item)</p>优势明显：
- 错误明确（
err != nil可直接判断连接/超时/序列化问题） - 连接池复用可控，避免每次请求新建 client
- 支持
GetMulti、Increment、Touch等高级操作，beego cache 接口不暴露这些 - 调试时可直接
mc.Stats()查看命中率、连接数等真实指标
唯一代价是放弃 beego cache 的统一接口抽象，但对生产级分布式缓存来说，这点可控性远比“框架一致性”重要。
