ThinkPHP 默认 Redis 驱动不支持 Redis Cluster，填多个 host 会被当作轮询单节点而非集群，导致连接失败或静默降级；必须使用 predis/predis（v1.1+）并自定义 RedisCluster 驱动类，重写 init 方法传入节点数组与 'cluster' => 'redis' 选项，TP6/TP8 均适用。
ThinkPHP 默认的 Redis 驱动不支持 Redis Cluster 协议，直接填多个 host 会被当成轮询单节点，不是真集群——连接会失败或静默降级，session 和 cache 都可能丢失数据。
TP6/TP8 直接写数组到 config/cache.php 的 redis.host 会失效
TP6 和 TP8 的内置 redis 缓存驱动只识别单节点或 Sentinel 模式。即使你把 'host' => ['192.168.1.41', '192.168.1.42'] 写进 config/cache.php，框架仍会尝试逐个 connect 单节点，不会启用集群路由逻辑。
- 现象：报
Connection refused、Failed to read from socket，或 key 写入后查不到 - 根本原因：TP 官方驱动没封装 phpredis 的
RedisCluster类，也没集成 predis 的集群自动发现 - 验证方式：在
php think tinker里执行(new \RedisCluster(null, ['192.168.1.41:6379']))->ping()，能通说明集群本身可用，问题出在 TP 配置层
必须用 predis/predis 并自定义驱动类（TP6/TP8 通用）
这是目前最稳定、无需改框架源码的方案。predis 原生支持 cluster 模式和 hash tag 路由，且能处理密码、超时、重试等生产细节。
- 安装：
composer require predis/predis:^1.1 - 新建
app/cache/driver/RedisCluster.php，继承 TP 的think\cache\driver\Redis，重写init方法： - 在
init中 newPredis\Client，传入节点数组和'cluster' => 'redis'选项 - 关键点：若 Redis 节点启用了密码，URL 必须带
?auth=xxx，例如'tcp://192.168.1.41:6379?auth=mypass' - TP8 注意：自定义驱动类的命名空间要匹配
app\cache\driver，且在config/cache.php的'stores' => ['redis' => [...]]中指定'handler' => \app\cache\driver\RedisCluster::class
Session 共享必须用独立 Handler，不能复用 cache 配置
TP 的 session 和 cache 是两套独立机制。即使 cache 已连上集群，session 仍走默认 file 或单点 redis，导致负载均衡后用户反复登出。
- 不能只改
config/session.php的'type' => 'redis'，必须同时设'store' => []并补全参数 - 更可靠的做法：手写
app/session/RedisClusterHandler.php实现SessionHandlerInterface，内部用同一个Predis\Client(['cluster' => 'redis'])实例 - 调用时机：在
public/index.php或中间件中，session_set_save_handler(new RedisClusterHandler(), true)必须在session_start()之前 - 易踩坑：
session.gc_maxlifetime要和 Redis key 过期时间对齐，否则 PHP 自己清理 session 文件，而 Redis 里还留着脏数据
真正生效的关键不在“填多少个 IP”，而在客户端是否理解 MOVED 重定向和 slot 分片规则——predis 做到了，TP 内置驱动没做。别跳过 redis-cli -c -h X.X.X.X -p 6379 cluster nodes 验证集群状态这步，假集群比没集群更难排查。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
