PHP 8.2下Redis缓存失效主因是phpredis扩展版本/线程安全/架构不匹配或cache.php/session.php配置缺失关键参数，须严格核对PHP版本、TS/NTS、x64/x86，并显式配置host/port/database/password/auth等字段，且cache与session需独立完整配置并分离database或prefix。
确认phpredis扩展已加载且匹配PHP 8.2
TP8.2 不会报错但直接 fallback 到 file 缓存，根源常在扩展没装对。别只看 php -m | grep redis 输出，还要核对三件事：
- 执行
php -v确认是 8.2.x（如 8.2.9） - 执行
php -i | findstr "Thread Safety"（Windows）或php -i | grep "Thread Safety"（Linux），确认是enabled（TS）还是disabled（NTS） - 执行
php -i | findstr "Architecture"确认是x64还是x86
这三项决定你要下载的 DLL/so 文件名——比如 PHP 8.2.9 + TS + x64，就得用 php_redis-5.3.7-8.2-ts-vs16-x64.dll。错一个字母，extension=php_redis.dll 就静默失效，php -m 也不显示 redis。
必须手动填满 config/cache.php 的 redis store
.env 里写 CACHE_STORE=redis 只是个开关，TP8.2 根本不读 REDIS_HOST 这类变量。真正起作用的是 config/cache.php 里显式写的连接参数，漏一项就降级为 file。
-
'default' => 'redis'：必须小写，不能是Redis或REDIS -
'stores' => ['redis' => [...]]中必须包含：'type' => 'redis'、'host' => '127.0.0.1'、'port' => 6379（整型！不是字符串"6379"）、'database' => 0（必须写，不写可能连错库）、'password' => ''（空密码也得显式写） - ACL 模式（Redis ≥6.0）下，把
'password'换成'auth' => 'your-pass'，并确认用户有+@all权限 - 加
'timeout' => 3.0（float 类型）防阻塞，'persistent' => true减少握手开销
session.php 也要配 store，不能只设 type
很多项目缓存走 Redis 成功了，但登录态一刷新就丢，问题出在 session 没配好。TP8.2 的 session Redis 驱动不复用 cache 配置，config/session.php 必须独立配全：
立即学习“PHP免费学习笔记（深入）”；
-
'type' => 'redis'是开关，但光有它不够 - 必须补上
'store' => ['host' => '127.0.0.1', 'port' => 6379, 'database' => 1, 'auth' => 'xxx']——缺'store'键，运行时直接报Call to a member function setOptions() on null - cache 和 session 强烈建议用不同
database（如 cache 用 0，session 用 1），比前缀更可靠；若只能共用，cache 加'prefix' => 'cache_'，session 加'prefix' => 'sess_' - 禁用 PHP 原生 GC：
ini_set('session.gc_probability', 0)，否则 Redis 里的 session key 可能被误删
验证是否真连上 Redis，别信配置文件写了就算数
配置写完 ≠ 缓存生效。最常踩的坑是“看起来正常，其实一直在用 file”。验证必须动手跑命令：
- 执行
php -r "var_dump(cache('test_key', 'test_value', 10));"→ 应输出string(11) "test_value" - 再执行
php -r "var_dump(cache('test_key'));"→ 若返回NULL，说明没走 Redis - 登录 Redis 执行
redis-cli -a your-pass keys "test_key"（或带 prefix 的 key），查不到就是连接失败或配置错 - 更底层验证：
php think tinker后运行(new \think\cache\driver\Redis(config('cache.stores.redis')))->handler()->ping()，返回+PONG才算通
连接失败时 TP8.2 默认静默降级，首次失败才记日志（搜 RedisException 或 Connection refused），后续复用连接池失败完全无提示——这是线上最难排查的问题之一。
