ThinkPHP Redis连接异常_长连接配置与存活检测-ThinkPHP-PHP中文网

redis连接异常主因是服务端空闲断连而tp未重连，需配置persistent=true启用长连接并设prefix防污染，swoole等常驻框架应改用连接池，且必须手动ping检测连接存活。

thinkphp redis连接异常_长连接配置与存活检测

Redis 连接异常：`Connection refused` 或 `read error on connection`

绝大多数 ThinkPHP 项目里 Redis 报错，不是密码或地址写错了，而是连接被服务端主动断开后，TP 没重连，还拿旧连接去读写。默认配置下，ThinkPHP 的 Redis 驱动用的是 PHP 原生 Redis 扩展的短连接模式——每次请求新建、用完即关，但实际部署中常配了 redis.conf 的 timeout 300（5 分钟空闲断连），而 TP 不检测连接是否还活着。

实操建议：

在 config/cache.php 或 config/redis.php 中显式开启长连接：'persistent' => true（注意：仅对 Redis 扩展生效，Predis 不支持）
必须配合设置 'prefix' => 'tp_' 类似的命名空间，否则多个进程/请求共用一个持久化 ID 会互相污染数据
若用 Swoole 或 Hyperf 等常驻内存框架，persistent 反而容易引发连接泄漏，此时应改用连接池（如 topthink/think-redis v3+ 的 pool 配置）

ThinkPHP 6.x 的 `Redis` 驱动不自动重连？

是的。think-redis 默认封装的 Redis 实例不做连接存活检测，$redis->get() 失败时直接抛异常，不会尝试 connect() 或 ping() 后重试。

实操建议：

在业务逻辑里手动加一层健壮性：调用前先 $redis->ping() === '+PONG'，失败则 throw new Exception('Redis unreachable') 并触发告警
不要依赖 try/catch 捕获所有 Redis 异常来“兜底重试”，因为像 read error on connection 很可能意味着 socket 已半关闭，重试大概率还是失败
如果用的是 think-queue 的 Redis 驱动，记得检查 config/queue.php 中 'redis' => ['options' => ['prefix' => 'queue:']] 是否和缓存配置隔离，否则 lpop 可能误删缓存 key

`phpredis` 扩展的 `connect()` 和 `pconnect()` 在 TP 里的实际行为差异

ThinkPHP 底层调用的是 new \Redis()，然后根据配置决定调 connect() 还是 pconnect()。关键区别不在“是否复用连接”，而在“连接生命周期归属”：前者由 PHP-FPM 进程控制，后者由操作系统内核维护，即使脚本结束也不释放。

实操建议：

pconnect() 要求 Redis 服务端配置 tcp-keepalive 60，否则中间网络设备（如云厂商 SLB）可能静默丢弃空闲连接
PHP-FPM 的 pm.max_requests 设为非零值时，长连接反而更容易出问题——因为进程重启时不会主动 close 持久化连接，导致 Redis 端积累大量 ESTABLISHED 状态连接
验证是否真正启用了长连接：用 redis-cli client list | grep -c "addr=" 查看连接数，压测前后对比；若只增不减，说明 persistent 生效了

Redis 连接池在 ThinkPHP 里怎么配才不踩坑？

官方 think-redis v3.0+ 支持连接池，但默认不启用，且文档没说清几个硬约束：它只对 Redis::handler() 返回的实例有效，不接管 Cache::store('redis') 的底层连接。

实操建议：

必须在 config/redis.php 中开启：'pool' => ['min_idle_count' => 1, 'max_idle_count' => 10]，否则仍走单连接
连接池初始化时机在第一次调用 Redis::handler() 时，如果项目启动阶段就执行 Cache::get()，会绕过池子直连，得提前 Redis::handler()->ping() 触发初始化
监控池子水位：通过 Redis::handler()->getPool()->getStats() 查看 idle/used 数量，避免 max_idle_count 设太小导致高并发下频繁创建销毁连接