Session 共享失效致频繁掉线？ThinkPHP 5.1 Redis 序列化模式修正【集群】-ThinkPHP-PHP中文网

tp5.1 redis session 配置必须写在 config/app.php 的 'session' 数组里，且需显式设 'driver' => 'redis' 及带 redis_ 前缀的完整字段（如 redis_host、redis_port 等），config/session.php 不被读取；须启用 php_redis 扩展，不支持 redis cluster 和 igbinary 序列化，密码仅支持传统 requirepass 模式。

session 共享失效致频繁掉线？thinkphp 5.1 redis 序列化模式修正【集群】

TP5.1 Redis Session 配置必须写在 `config/app.php` 的 `'session'` 数组里

很多人把 redis_host、redis_port 等配置扔进 config/session.php，结果 session 始终走 file 驱动——TP5.1 根本不读这个文件。框架只认 config/app.php 里 'session' => [] 下的键，且必须显式写 'driver' => 'redis'，光写 'type' => 'redis' 不生效。

常见错误现象：session_start(): Cannot send session cookie，或登录后刷新就登出。本质是 session 驱动没加载成功，退回到 file 后又因 runtime/session/ 权限问题失败。

config/app.php 中必须包含完整字段：'driver'、'redis_host'、'redis_port'、'redis_password'（如有）、'redis_database'（建议设为 0 或 1，别省）
不要用 host/port 这种简写，TP5.1 的 Redis session 驱动只识别带 redis_ 前缀的键
PHP 扩展必须启用：extension=redis.so（Linux）或 extension=php_redis.dll（Windows），php -m | grep redis 能看到才有效

Redis Cluster 场景下 Session 会静默失效，根本原因是 multi-key 操作被拒绝

TP5.1 的 \think\session\driver\Redis 默认用 zAdd + lPop + zRemRangeByScore 组合管理 session 生命周期，这些操作涉及多个 key（如 session:xxx、session:xxx:expire）。Redis Cluster 要求所有 key 在同一 slot，但 TP5.1 没做 key tag 处理，导致命令被重定向或直接报错 CROSSSLOT Keys in request don't hash to the same slot，而框架捕获异常后降级为 file 驱动——你完全看不到报错，只觉得“掉线了”。

Ai Session Analysis

用于分析本地AI编程助手会话数据（如Claude Code、Codex、Kimi Code）。当用户请求分析编程会话时触发。

下载

别在 Redis Cluster 上跑 TP5.1 的 session，它不支持；改用单节点或主从模式（Sentinel）
如果必须用集群，得自己重写 \think\session\driver\Redis，对所有 key 加 {session} tag，例如把 session:abc 改成 {session}session:abc
注意：TP5.1 没内置 Redisd 驱动（专为集群设计），Redisd 是 TP6+ 引入的，TP5.1 即使装了也无效

序列化不一致导致 get() 返回 `null`，不是连接问题而是解码失败

你在 TP8 或其他项目往 Redis 写过 session，再切回 TP5.1 读，大概率返回 null。因为 TP8 默认用 igbinary 序列化，而 TP5.1 只认 PHP 原生 serialize()；反过来也一样——TP5.1 写的 session，TP8 读时若开启 igbinary 会直接 decode 失败，无任何提示。

TP5.1 的 session 驱动不提供 serializer 配置项，无法切换序列化方式；唯一办法是统一用 PHP 原生序列化
检查 Redis 里的 raw value：用 redis-cli 执行 get "session:xxx"，如果看到类似 a:2:{s:3:"uid";i:123;s:5:"login";b:1;} 就是 PHP serialize；如果是一串乱码（开头是 \x00\x00\x00），那就是 igbinary，TP5.1 解不开
清除所有旧 session 数据，确保全量由 TP5.1 写入，是最稳妥的做法

密码配置写错位置或格式，会导致认证失败后静默 fallback 到 file

Redis 开了密码，但 TP5.1 的 session 配置里只写了 'redis_password' => '123456'，依然连不上——因为驱动实际调用的是 new \Redis()，然后执行 $redis->auth($password)，而这个过程若失败，框架不会抛异常，而是直接放弃 Redis，切回 file。

确认 Redis 服务端配置：检查 redis.conf 中 requirepass 是否启用，且密码与配置一致
TP5.1 不支持 ACL 模式下的 auth 用户名+密码组合，只支持传统单密码；如果你用了 ACL SETUSER，得降级为 requirepass
测试连接是否真通：在控制器里临时加一段 $redis = new \Redis(); $redis->connect('127.0.0.1', 6379); $redis->auth('123456');，看会不会 throw exception

TP5.1 的 Redis session 机制简单粗暴，没有兜底日志、不报连接异常、不校验配置完整性——它假定你填的每个字段都合法且服务端已就绪。一旦某处偏差（比如少个 redis_database、密码多空格、Redis 实际监听 127.0.0.1:6380 却配了 6379），就会静默退到 file，而 file 在并发或容器环境下极易出问题。排查时别只盯代码，先用 redis-cli 和 php -r "new Redis();..." 两级验证，比翻日志更快。