Memcached扩展未启用导致驱动初始化失败，需确认PHP已加载memcached扩展（≥3.2.0）、正确配置host/port、避免key非法字符、expire设为负数会立即失效。
Memcached扩展未启用导致Memcached驱动初始化失败
ThinkPHP 6+ 默认不强制依赖 Memcached 扩展，但启用 Memcached 缓存驱动前必须确保 PHP 已加载 memcached 扩展（注意不是 memcache），且版本 ≥ 3.2.0。常见错误是配置了驱动却报 Class 'Memcached' not found 或 Cache handler is not available。
- 运行
php -m | grep memcached确认扩展已启用；若无输出，需安装并启用（如 Ubuntu：`sudo apt install php-memcached`，然后检查php.ini中是否含extension=memcached.so） - 确认扩展支持的协议版本：ThinkPHP 的
Memcached驱动默认使用Memcached::SERIALIZER_PHP，若服务端禁用 PHP 序列化（如某些云 Memcached 实例），需手动切换为Memcached::SERIALIZER_IGBINARY（需服务端也支持） - Windows 下易混淆
memcache.dll（旧扩展）与memcached.dll（新扩展），务必用phpinfo()查看实际加载的扩展名和类是否存在Memcached
ThinkPHP 6+ 中正确配置memcached缓存驱动
配置位置在 config/cache.php，关键不是改驱动名，而是补全 Memcached 实例所需的连接参数。默认的 'handler' => \think\cache\driver\Memcached::class 仅声明类型，不等于自动连通。
-
'host'和'port'必须显式指定，即使使用默认值（'127.0.0.1'和11211），否则会 fallback 到空连接，后续操作静默失败 - 若使用多服务器集群，需传入数组形式的
'servers'参数（非'host'），例如：['servers' => [['host' => '192.168.1.10', 'port' => 11211], ['host' => '192.168.1.11', 'port' => 11211]]，此时'host'/'port'将被忽略 -
'weight'可为每个 server 指定权重（整数），影响 key 分布，但 ThinkPHP 不自动做一致性哈希；如需更均衡分布，建议开启Memcached::OPT_LIBKETAMA_COMPATIBLE（需在实例创建后 setOption） - 连接超时建议设为
'timeout' => 1000（毫秒），避免阻塞请求；长期连接可加'persistent_id' => 'tp6_mc'复用连接池
缓存键命名冲突与序列化陷阱
ThinkPHP 对键名自动添加前缀（如 think:），但 Memcached 本身对 key 长度（≤ 250 字节）、字符集（仅 ASCII）敏感。常见现象是写入成功、读取返回 null，实则因 key 被截断或非法字符被静默过滤。
- 避免在 key 中使用中文、空格、控制字符；推荐用
md5($original_key)或sha1($original_key)做标准化处理（尤其当 key 来自用户输入） - ThinkPHP 默认使用 PHP 序列化，但若服务端禁用或扩展编译时未启用 igbinary，会导致反序列化失败——此时
get()返回 false 而非抛异常；可在驱动构造后手动调用$memcached->setOption(Memcached::OPT_SERIALIZER, Memcached::SERIALIZER_PHP)显式确认 - 批量操作（
getMultiple）在 ThinkPHP 中由TagSet或自定义封装实现，原生驱动不支持 tag，需自行拼接前缀 + 使用getMulti方法绕过
性能瓶颈常出在连接复用与过期策略上
频繁 new Memcached 实例比复用连接慢 3–5 倍；而错误设置 expire（如传入负数或 0）会导致 key 永不过期，挤占内存。
立即学习“PHP免费学习笔记（深入）”；
- 不要在每次缓存操作中 new 驱动实例；ThinkPHP 容器会单例管理，但若手动 new
\think\cache\driver\Memcached，务必复用对象或使用Cache::store('memcached')获取统一实例 -
'expire'配置项单位是秒，设为0表示永不过期，设为负数（如-1）会被 Memcached 当作“相对当前时间的 Unix 时间戳”，极易误设成过去时间，结果立即失效 - 高并发下建议开启
Memcached::OPT_BINARY_PROTOCOL => true（需服务端支持），减少协议解析开销；测试表明 QPS 可提升 12%～18% - 监控真实命中率比理论配置更重要：通过
stats命令查get_hits / cmd_get比值，低于 0.7 说明缓存设计或 key 分布有问题，而非驱动配置问题
真正卡住的往往不是“怎么配”，而是扩展没装对、key 含非法字符、expire 设成负数却不报错、或者以为开了 persistent_id 就自动复用——其实它只在同进程内生效，FPM 下每个 worker 还是独立连接池。
