TP8 Redis连接失败时静默降级为file驱动，导致缓存不生效、登录态丢失；须显式配置host/port/database/auth等参数，隔离cache与session的database，并禁用PHP原生session GC。
PHP8连接Redis失败时，页面无报错但缓存不生效、登录态丢失、队列任务堆积，这类问题往往卡在配置环节而非代码逻辑——因为TP8对Redis连接失败采取静默降级策略，file驱动会悄悄接管，掩盖真实故障。
确认PHP已加载redis扩展
执行 php -m | grep redis，若无输出说明扩展未启用。
检查 php.ini 中是否已添加 extension=redis.so，且路径下该文件真实存在：运行 php --ri redis，若提示“Extension 'redis' not present”，则扩展未加载成功。
【必须验证 extension_dir 路径是否正确】：用 php -i | grep extension_dir 查出实际目录，再确认 redis.so 是否在此路径下；常见错误是编译生成的 so 文件被复制到了错误的 zts/non-zts 子目录中。
立即学习“PHP免费学习笔记（深入）”；
检查Redis服务状态与网络连通性
先确保 Redis 进程正在运行：systemctl is-active redis-server 或 redis-cli ping，返回 PONG 才算通。
若本地无法 ping 通，检查是否绑定了 127.0.0.1 而非 0.0.0.0（/etc/redis/redis.conf 中 bind 配置），或防火墙拦截了 6379 端口。
远程连接时，【Redis 默认禁用远程访问】：需注释掉 bind 127.0.0.1 并设 protected-mode no，改完必须 systemctl restart redis-server。
ThinkPHP8中显式填写Redis连接参数
第一步：打开 config/cache.php，定位到 'stores' => ['redis' => [...]] 数组。
第二步：确认以下字段全部显式写出，不可留空、不可注释、不可依赖默认值：
① 'host' => '127.0.0.1'（不能写 localhost，某些系统解析慢或失败）
② 'port' => 6379（必须是整数，不能加引号）
③ 'database' => 0（必须声明，哪怕为 0；否则 phpredis 可能连错库）
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
④ 若 Redis 启用 ACL（≥6.0），用 'auth' => 'your_password'；若为老版本 AUTH，则用 'password' => 'your_password'——二者混用会导致静默认证失败。
第三步：打开 config/session.php，同样检查 'store' 数组是否完整，只写 'type' => 'redis' 而不填 'store' 会直接抛出 Call to a member function setOptions() on null。
隔离 cache 与 session 的 Redis 数据库
方法一：分配不同 database（推荐）
在 config/cache.php 中设 'database' => 0，在 config/session.php 中设 'database' => 1。这是最彻底的 key 空间隔离方式，避免 session 键与缓存键冲突导致误删。
方法二：强制添加 prefix（仅当只能共用 database 时使用）
在 config/cache.php 的 redis store 中加入 'prefix' => 'cache_'；在 config/session.php 的 store 中加入 'prefix' => 'sess_'。注意 TP8 默认 prefix 为空字符串，think: 前缀是 Cache 类拼的，session 完全不加，不可靠。
禁用 PHP 原生 session GC 防止登出异常
在 config/session.php 中添加如下代码：
ini_set('session.gc_probability', 0);
否则 PHP 会在每次请求概率性触发垃圾回收，扫描 Redis 中所有 session key 并误删过期项，造成用户莫名登出——这个设置必须写在 session 配置文件里，不能只放在入口或中间件中。
手动验证 Redis 连接是否真正生效
进入项目根目录，执行：php think tinker
输入以下命令测试：
(new \think\cache\driver\Redis(config('cache.stores.redis')))->handler()->ping()
返回 +PONG 表示连接通且认证通过；若报错或返回 null，说明配置仍存在问题，此时才应排查日志中的 RedisException 或 Connection refused。
