ThinkPHP Redis缓存连接失败主因是框架未真正连上Redis而静默降级为file驱动，须同时满足：启用phpredis扩展、安装topthink/think-redis包、在config/cache.php中完整配置stores.redis（type小写、select为整数、password显式声明）、session与cache分离database、并通过php think tinker执行ping验证。
ThinkPHP Redis 缓存连接失败，表面看是“缓存不生效”或“登录后登出”，实际多数情况并非 Redis 服务宕了，而是框架压根没连上——而且不报错、不提示，悄悄退化成 file 驱动。问题根源集中在配置、扩展、隔离三块，漏一项就失效。
PHP 扩展和驱动包必须齐备
缺一不可：原生 phpredis 扩展 + Composer 官方驱动包 topthink/think-redis。
- 运行
php -m | grep redis，输出必须有redis；没有就说明扩展未加载，改 php.ini 加extension=redis.so（Linux）或extension=php_redis.dll（Windows），改完必须重启 PHP-FPM 和 Web 服务器 - 执行
composer require topthink/think-redis，装完检查vendor/topthink/think-redis/src/Driver.php是否存在；不装这个包，Cache::store('redis')会直接抛Driver not supported - 别装
predis/predis或phpredis/phpredis—— 这些不是 TP 的适配器，装了也没用
config/cache.php 必须写全参数，不能依赖 .env
.env 里设 CACHE_STORE=redis 只是开关，所有连接参数必须硬编码在 config/cache.php 的 stores.redis 块里，少一个就静默 fallback。
-
'type' => 'redis'：必须全小写，'Redis'或'REDIS'都无效 -
'host' => '127.0.0.1'、'port' => 6379、'select' => 0（整数！不能写"0"）、'password' => ''（空密码也得显式写） - Redis ≥6.0 启用 ACL 时，
'password'改为'auth' => 'your_user_pass'，且用户需有+@all权限 - 不支持
redis://URL 格式，只认拆开的 host+port+select
session 和 cache 必须分离，且禁用 PHP GC
共用一个 Redis 实例可以，但不能共用 database 或放任 PHP 自动清理 session。
立即学习“PHP免费学习笔记（深入）”；
- 在
config/session.php中，不能只写'type' => 'redis'；必须补全'store' => ['host' => '127.0.0.1', 'port' => 6379, 'database' => 1, 'auth' => 'xxx'] - cache 用
database => 0，session 用database => 1，比加 prefix 更可靠，避免 key 冲突或误删 - 在
config/session.php或入口文件中加：ini_set('session.gc_probability', 0)，否则 PHP 的 GC 机制可能清掉 Redis 中本该自动过期的 session，导致用户莫名登出
验证是否真连上，别信“没报错就是通了”
连接失败时 TP8 默认静默降级，日志里可能只有一次 Connection refused，后续完全无提示。最准的验证方式：
- 进项目根目录执行：
php think tinker - 输入：
(new \think\cache\driver\Redis(config('cache.stores.redis')))->handler()->ping() - 返回
+PONG才算真正通；返回 false、null 或报错，说明参数错、认证失败或 DB 不对 - 顺便用
redis-cli -a your_pass -n 0 KEYS *看 DB 0 里有没有think:*开头的 key，没有就说明写入根本没成功
