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

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

先说几个核心判断：TP5.1 的 Redis session 配置其实没什么玄学，但坑全藏在细节里。很多人翻来覆去配不对，归根结底是不知道框架到底读哪个配置文件、驱动用什么键名、扩展有没有装对。下面把几个最容易踩的雷拆开来讲。

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 的 thinksessiondriverRedis 默认用 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 驱动——你完全看不到报错，只觉得“掉线了”。

• 别在 Redis Cluster 上跑 TP5.1 的 session，它不支持；改用单节点或主从模式（Sentinel）
• 如果必须用集群，得自己重写 thinksessiondriverRedis，对所有 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；如果是一串乱码（开头是 x00x00x00），那就是 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();..." 两级验证，比翻日志更快。