ThinkPHP 8.0 Redis 缓存连接失败主因是配置未显式写全：必须在config/cache.php和config/session.php中完整填写host、port、database（整型）、type（小写）、password/auth、timeout等参数，漏一项即静默降级为file驱动；.env中REDIS_HOST等变量被完全忽略，仅CACHE_STORE=redis起开关作用。
升级到 ThinkPHP 8.0 后 Redis 缓存连接失败，不是配置“没生效”，而是 TP8 彻底弃用了 TP6 的自动环境变量解析逻辑——CACHE_STORE=redis 这类 .env 配置只控制开关，所有连接参数必须在 config/cache.php 和 config/session.php 中显式、完整、类型准确地写出，漏一项就会静默 fallback 到 file 驱动。
cache.php 里 redis store 必须写全 host/port/database/type
TP8 不再从 .env 读取 REDIS_HOST、REDIS_PORT 等字段，这些变量完全被忽略。你必须手动填满 'stores' => ['redis' => [...]] 里的每一项：
-
'type' => 'redis'：小写，不能是'Redis'或'REDIS' -
'host' => '127.0.0.1'：不能省略，也不能写成'localhost'（DNS 解析可能失败） -
'port' => 6379：必须是整型，写成"6379"会静默失败 -
'database' => 0：必须显式声明整数，不写或写成"0"可能导致SELECT命令报错 -
'password' => ''或'auth' => 'xxx'：ACL 模式下用auth，空密码也要写''，不能留空键 -
'timeout' => 3.0：建议 float 类型，避免连接卡死
session.php 的 redis store 不能只设 type
TP8 的 session Redis 驱动不再复用 cache 配置，只写 'type' => 'redis' 而不补 'store' 数组，运行时直接抛出 Call to a member function setOptions() on null 错误：
- 必须完整写
'store' => ['host' => '127.0.0.1', 'port' => 6379, 'database' => 1] -
cache和session强烈建议用不同database（如 cache=0，session=1），比前缀更可靠 - 若共用 database，必须加
'prefix' => 'sess_'，且确保 cache 的 prefix 是'cache_'，两者不能重叠 - 务必禁用 PHP 原生 GC：
ini_set('session.gc_probability', 0)，否则 Redis 中的 session key 可能被误删
连接失败不报错，但功能悄悄降级
TP8 对 Redis 连接失败采用“静默兜底”策略：首次失败会记日志（搜 RedisException 或 Connection refused），后续复用连接池失败则完全无提示，直接切到 file 缓存或 file session。典型现象包括：
- 登录后刷新页面变未登录
-
Cache::set('x', 'y')返回true，但Cache::get('x')返回null - 接口响应时间忽高忽低（部分请求走 Redis，部分走磁盘）
- 验证方式：执行
php think tinker→(new \think\cache\driver\Redis(config('cache.stores.redis')))->handler()->ping()，返回+PONG才算通
扩展和驱动注册必须重新确认
TP6 的 topthink/think-redis 包在 TP8 中仍可用，但需确认是否已正确加载：
- 执行
php -m | grep redis，输出必须含redis（不是redis.so或其他）；若无，说明 phpredis 扩展未启用 - TP8 仍依赖原生
redis扩展（非predis），composer require topthink/think-redis是必须步骤，否则报Driver [redis] not supported - 检查
vendor/topthink/think-redis/src/Provider.php是否存在，该包通过服务提供者注册驱动 - 若使用 Swoole 或 CLI 模式，需手动调用
ThinkRedisServiceProvider::register()
最易被忽略的是：TP8 的缓存连接参数没有默认值可依赖，database、port、host 全部必须显式写出，且类型必须严格匹配——哪怕你本地开发时一切正常，上线后因环境差异（如 Docker 网络、ACL 密码、防火墙）导致某一项不匹配，就会彻底静默退回到 file 驱动，而日志里连 warning 都没有。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
