PHPStorm数据库工具不支持Redis Cluster，因其仅兼容单节点协议，无法处理MOVED/ASK重定向及槽位映射；必须改用Predis或phpredis客户端配合断点调试或代码验证。
phpredis 不支持原生 Redis Cluster 自动发现
直接用 phpredis 连 Redis 集群时，RedisCluster 类要求你**手动列出全部主节点（含端口）**，它不会自动获取集群拓扑。如果你只配一个地址，new RedisCluster(['127.0.0.1:7000']) 会连上，但一旦该节点下线或重定向（MOVED/ASK），就会报 RedisClusterException: No cluster node available 或静默失败——这不是 Laravel 的锅，是 phpredis 底层限制。
测试集群连通性必须逐节点 ping + key 槽路由验证
不能只靠 redis-cli -c -h 127.0.0.1 -p 7000 ping 就认为集群可用。Laravel 用的是客户端分片（cluster => 'redis'）或直连 RedisCluster，必须验证两点：
- 每个节点 TCP 可达且认证通过（
telnet 127.0.0.1 7000或nc -zv 127.0.0.1 7000） - 任意节点能正确响应槽路由查询：运行
redis-cli -c -h 127.0.0.1 -p 7000 cluster nodes，输出中每行应含master标志且无fail状态；再试redis-cli -c -h 127.0.0.1 -p 7000 set test:123 hello，确认不报 MOVED 错误且值可 get 到
Laravel8x 中用 phpredis 测试集群的最小可行代码
在 tinker 里执行以下代码，它绕过 Laravel 的配置封装，直调 phpredis 扩展验证：
$nodes = [
'127.0.0.1:7000',
'127.0.0.1:7001',
'127.0.0.1:7002',
];
try {
$cluster = new RedisCluster(null, $nodes, 0, 0, true, $_ENV['REDIS_PASSWORD'] ?? null);
$cluster->set('laravel:test', 'ok');
var_dump($cluster->get('laravel:test')); // 应输出 string(2) "ok"
} catch (RedisClusterException $e) {
echo "集群异常：" . $e->getMessage();
}
注意：$_ENV['REDIS_PASSWORD'] 必须显式传入，phpredis 不从环境变量自动读取；若密码为空，传 null 而非空字符串。
立即学习“PHP免费学习笔记（深入）”；
config/database.php 配置 phpredis 集群时最易错的三处
Laravel 默认不支持 phpredis 的集群模式（RedisCluster），强行配会报 Class 'Predis\Client' not found 或 Call to undefined method Redis::connect()。正确姿势是：
-
'client' => 'phpredis'仅适用于单机 —— 集群必须切回'client' => 'predis'并设'options' => ['cluster' => 'redis'] - 若坚持用 phpredis，需自定义
RedisManager，重写resolve方法返回RedisCluster实例，否则 Laravel 的Redis::connection()根本不识别集群配置 -
clusters.default数组里的每个节点必须带端口（'127.0.0.1:7000'），不能只写 host+port 分离字段，phpredis 的构造器不解析这种结构
真正上线前，别信配置文件里写了“cluster”就万事大吉——集群的故障往往藏在某个节点的防火墙、密码不一致、或槽分配不均里，这些只有逐节点 telnet + cluster nodes + set/get 组合验证才能暴露。
