Session共享失败主因是配置未对齐、序列化不兼容或key空间污染；TP8中必须显式补全config/session.php的store数组，且host/port/database/auth/timeout等参数缺一不可，database须为整型，ACL模式用auth而非password，cache与session应分用不同database或统一prefix，禁用PHP原生GC，并验证序列化方式兼容性。
Session 共享失败，90% 不是 Redis 没连上，而是配置没对齐、序列化不兼容、或 key 空间被污染——尤其在多子应用或跨版本混合部署时。
config/session.php 的 store 配置漏项直接报错
只写 'type' => 'redis' 不够，TP8 会因找不到 store 实例而抛出 Call to a member function setOptions() on null。必须显式补全 store 数组，且每个键都不能缺。
-
'host'和'port'必须写死，不能依赖默认值（哪怕本地是 127.0.0.1:6379） -
'database'必须为整型（如1），设成字符串"1"或留空会导致 redis 命令执行失败 - Redis ≥6.0 启用 ACL 时，
'password'要换成'auth' => 'user:pass'，且该用户需有+@all权限 -
'timeout'建议设为3.0（float），避免连接卡死阻塞整个请求
多个 ThinkPHP 应用共用 Redis 时 key 冲突
TP8 默认不加前缀，所有应用往同一个 database 写 PHPSESSID_abc123，结果互相覆盖。这不是“偶尔失效”，而是必然撞车。
- 最稳妥做法：cache 用
database => 0，session 用database => 1，物理隔离 - 若只能共用一个 DB，必须在
config/session.php中强制设'prefix' => 'sess_'（注意结尾下划线） - 别信“TP 自带 prefix”——
think:session:是旧版习惯，TP8 的 Redis store 默认 prefix 是空字符串 - 子应用间共享 Session，所有应用的
'prefix'必须完全一致（比如都设''或都设'admin_'），否则 www 写的 key，admin 根本不读
TP5.x 与 TP6+/8.0 序列化方式不兼容
TP5 默认用 serialize()，TP6+ 默认用 json_encode()。混用会导致 $_SESSION 始终为空，但无任何错误提示——你看到的是“登录成功”，实际 session 数据根本没写进去。
立即学习“PHP免费学习笔记（深入）”；
- 确认当前项目版本：运行
php think version - 若需兼容老数据或含资源句柄的 session，强制在
config/session.php加'serialize' => 'php' - 若新项目纯 JSON 可用，但注意：
null、resource、object无法 JSON 序列化，会丢数据 - 检查 Redis 里实际存的 key 值：用
redis-cli -a yourpass -n 1 keys "PHPSESSID_*"查看内容是否为 JSON 或 PHP serialized 字符串
连接失败静默降级导致问题隐蔽
TP8 对 Redis 连接失败不做中断处理，而是悄悄 fallback 到 file 驱动。现象是“登录态看似正常”，实则没走 Redis——刷新即登出、缓存 set 成功但 get 返回 null。
- 上线前必须手动验证：运行
php think tinker，执行(new \think\cache\driver\Redis(config('cache.stores.redis')))->handler()->ping()，返回+PONG才算通 - 日志只记录首次连接失败（搜
RedisException或Connection refused），连接池复用失败不记日志 - 禁用 PHP 原生 GC：
ini_set('session.gc_probability', 0)，否则 Redis 里的 session key 可能被误删 - 反向代理（如 Nginx）必须透传 Cookie 头：
proxy_set_header Cookie $http_cookie，否则 session_id 根本传不到后端
真正难排查的不是“连不上 Redis”，而是“连上了，但写错库、序列化错格式、前缀对不上、GC 把 key 清了”——这些细节一旦漏掉一个，Session 就变成单机行为，集群形同虚设。
