Memcached扩展未正确安装或配置会导致ThinkPHP Session失败。需确保PHP启用memcached扩展（≥3.0.0）、配置项type为全小写“memcached”、正确设置host/port、启用persistent_id连接池、设置expire过期时间，并避免session ID复用与大数组写入。
Memcached扩展没装好，session_start() 直接报错
ThinkPHP 用 Memcached 做 Session 驱动，前提是 PHP 环境里 memcached 扩展（不是 memcache）必须已启用，且版本 ≥ 3.0.0。常见错误是只装了 memcache 扩展，或者装了 memcached 但没启——这时 session_start() 会抛出 Failed to initialize storage module。
- 检查命令：
php -m | grep memcached，有输出才说明扩展就位 - 确认
php.ini中已取消注释：extension=memcached - 如果用的是 Docker，注意基础镜像是否预装；Alpine 镜像需额外装
php82-pecl-memcached类似包 - 扩展装对了，但连不上 Memcached 服务时，错误会延迟到 session 写入时才暴露，表现为页面空白或 500，日志里出现
Memcached::set(): Server 127.0.0.1:11211 connection failed
ThinkPHP 配置里写错驱动名或参数键名
TP6 默认支持的 Session 驱动名是 memcached（全小写），不是 memcache 或 Memcached。配置项键名也容易错：比如把 host 写成 hostname，或漏掉 port 导致默认连 11211 失败（而你的服务其实在 11212）。
- 正确配置路径：
config/session.php中设'type' => 'memcached' - 必需参数只有
host和port；weight可选，集群多节点时才用 - 示例有效片段：
'memcached' => [ 'host' => '10.0.1.5', 'port' => 11211, 'weight' => 1, ], - TP 不会自动 fallback 到 file 驱动——配错就直接崩，不会静默降级
Session ID 被复用导致并发请求串数据
Memcached 是纯内存、无持久化、无事务的存储，ThinkPHP 的 memcached 驱动在高并发下若未显式设置过期时间，可能因 key 冲突或服务端 LRU 清理不及时，让不同用户的 PHPSESSID 对应到同一块内存区域。
- 务必在
config/session.php中设'expire' => 7200（单位秒），不能依赖 Memcached 默认 TTL - 避免手动调用
session_id()后再session_start()，TP 的 memcached 驱动对自定义 ID 支持弱，易丢数据 - 集群环境多个 Web 节点共用一套 Memcached 时，确保所有节点的
session.name（如PHPSESSID）和cookie.domain一致，否则浏览器发错 session ID - 别在控制器里用
$_SESSION直接赋值大数组——Memcached 单 key 值建议 ≤ 1MB，超了会静默截断
连接池没开，短连接压垮 Memcached
ThinkPHP 默认每次 session 操作都新建/关闭 Memcached 连接，QPS 上千时，连接建立开销和 TIME_WAIT 积压会让 Memcached 服务响应变慢甚至拒绝新连接。
立即学习“PHP免费学习笔记（深入）”；
- 必须开启长连接：在
config/session.php的memcached配置里加'persistent_id' => 'tp_session_pool' -
persistent_id是连接池标识符，同名即复用连接；不同应用要区分命名，避免互相干扰 - 确认 Memcached 服务端配置允许足够多并发连接（
-c 4096启动参数） - 没开 persistent_id 时，
netstat -an | grep :11211 | wc -l会看到大量 ESTABLISHED + TIME_WAIT，开了之后稳定在个位数
Memcached 做 Session 最脆弱的环节不在配置，而在“以为配完就稳了”——它不报错，但会在流量高峰时悄悄丢 session、混用户数据、或让整站卡顿三秒。测的时候别只看单请求 OK，得用 ab 或 wrk 模拟 100 并发持续 2 分钟，盯着 stats 输出里的 curr_connections 和 evictions。
