Redis连接问题需逐层排查：先确认PHP Redis扩展是否安装启用，再检查Redis服务状态、网络权限（防火墙/安全组）、ThinkPHP配置（host、password、database类型等），最后验证连接池与长连接设置。
Redis 扩展没装或没启用
ThinkPHP 启动时抛出 Class 'Redis' not found 或 Driver [redis] not supported，第一反应不是配置错，而是 PHP 根本没加载 Redis 扩展。尤其在宝塔、AMH 或手动编译的环境下，扩展常被漏装或禁用。
- 用
php -m | grep redis看命令行是否加载；Web 环境还要单独检查phpinfo()页面里的 Loaded Extensions - Linux 下常见路径是
/usr/lib/php/20220829/redis.so（版本号随 PHP 版本变），确认extension=redis.so在正确的php.ini里（注意 CLI 和 FPM 的php.ini可能不同） - 如果用的是
phpredis扩展（非predis），别误装成composer require predis/predis—— 那只是纯 PHP 客户端，不解决扩展缺失问题
Redis 服务连不上：权限与网络双关卡
报错变成 Connection refused 或 Operation timed out，说明 ThinkPHP 找到扩展了，但连不到 Redis 实例。这时候得同时查服务端和客户端限制。
- 先确认 Redis 进程在跑：
systemctl status redis-server（Ubuntu/Debian）或systemctl status redis（CentOS） - 默认绑定
127.0.0.1，若 ThinkPHP 配置了host=127.0.0.1却仍连不上，可能是 SELinux 拦了（CentOS）或防火墙封了6379端口：firewall-cmd --list-ports - 云服务器（如阿里云、腾讯云）必须检查安全组规则——
6379端口默认不放行，本地测试通 ≠ 线上通 - 如果 Redis 改过密码，ThinkPHP 的
password配置项不能留空，也不能填错；空密码也要显式写password = ''，否则部分版本会当作未设密码处理
ThinkPHP 配置项写错位置或类型
明明扩展和连接都 OK，缓存还是不走 Redis，大概率是配置没落到实际生效的地方。ThinkPHP 6+ 的缓存驱动配置分散在多个层级，容易套娃失效。
- 核心配置在
config/cache.php的default驱动下嵌套stores.redis，不是直接平级写host、port -
host值别写成localhost——某些系统 DNS 解析慢或失败，强制用127.0.0.1更稳 -
database参数是整数（如0），不是字符串'0'；写成字符串会导致连接后 select db 失败，日志里可能只显示 “AUTH failed” 这类误导信息 - 如果用了哨兵或集群模式，
type必须设为sentinel或cluster，且对应字段（如sentinels）结构要严格匹配文档，少一个键就静默降级为单机模式
连接池或长连接引发的超时假象
上线后偶发 read error on connection 或 Connection lost，不是网络抖动，而是 Redis 连接复用出了问题。ThinkPHP 默认开启长连接，但服务器端可能主动断开空闲连接。
立即学习“PHP免费学习笔记（深入）”；
- 检查 Redis 配置里的
timeout（单位秒），默认是0（永不断），但很多生产环境设为300或60；PHP 客户端没做心跳，连接池里“睡着”的连接醒来就废了 - 临时解法是在 ThinkPHP 的 Redis 配置里加
'options' => ['prefix' => 'tp6:']这类无关参数——看似无用，实则触发连接重建逻辑；长期方案是加'persistent' => false关闭长连接 - 如果用的是 Swoole 或 Hyperf 类常驻进程框架，Redis 连接不能复用在多请求间，必须每次 new 一个新实例，否则连接状态混乱
Redis 连接问题从来不是单点故障，它横跨 PHP 扩展、系统服务、网络策略、框架配置四层。调不通时，别急着改代码，先用 telnet 127.0.0.1 6379 和 php -r "new Redis(); echo 'ok';" 两级验证，比翻十页文档快得多。
