phpstorm 数据库工具不支持 redis cluster，因其仅兼容单节点协议，无法处理 moved/ask 重定向及槽位映射；需改用 predis 客户端配合断点调试，注意哈希标签、全局密码配置及终端验证连通性。
PHPStorm 连 Redis 集群不支持直接连接
PHPStorm 的数据库工具窗口（Data Source → Redis）**完全不支持 Redis Cluster 模式**。它底层调用的是单节点 Redis 协议，无法解析 MOVED / ASK 重定向响应，也不会维护槽位映射表。你填一堆节点地址、开 cluster 模式、甚至写 redis://127.0.0.1:7000 到 host 字段，IDE 都会当作普通单机连——结果必然是 Connection refused 或执行命令时直接报错 CROSSSLOT。
这不是配置问题，是功能缺失。官方文档至今未声明对 Cluster 的支持，插件页里也找不到任何“Redis Cluster”扩展。
替代方案：用 PHP 脚本 + 断点调试代替 IDE 数据源
真正可行的「高级调试」路径是绕过 PHPStorm 的 Redis 数据源，改用 PHP 代码驱动集群客户端，并在关键位置打断点观察行为。重点不是让 IDE 显示 key 列表，而是看清客户端如何路由、重试、失败降级。
- 必须用
Predis\Client（非Redis扩展），并显式传入完整节点数组：['nodes' => [['host' => '192.168.1.10', 'port' => 7000], ...]] - 在连接后立刻加断点，检查
$client->getConnection()->getCluster()->getNodes()是否返回全部主节点 - 执行
$client->get('user:{123}:profile')时，停在Predis\Connection\Aggregate\RedisCluster::executeCommand()内部，看实际发往哪个 socket - 故意停掉一个节点，再触发命令，观察是否自动 failover 到从节点（需配置
'replication' => 'sentinel'或启用 Predis 的replication模式）
调试时 key 必须带 hash tag，否则断点也救不了
即使 Predis 正常工作，MGET user:1001:profile user:1002:settings 这类操作在集群下必然失败，PHPStorm 里跑脚本也会抛 CROSSSLOT 异常。IDE 不会帮你加花括号，得你自己写：
$client->mget(['user:{1001}:profile', 'user:{1001}:settings']); // ✅ 同槽
$client->hmget('user:{1001}', ['name', 'email']); // ✅ 支持
漏掉花括号是集群调试中最隐蔽的坑——错误发生在运行时，IDE 变量监视里只看到空结果或异常，根本看不出是哈希槽不一致。
密码和 requirepass 的配置位置容易搞反
如果集群启用了密码，Predis\Client 构造时必须把密码放在 parameters 顶层，而不是每个 node 里单独配：
$client = new Predis\Client([
'scheme' => 'tcp',
'cluster' => 'redis',
'parameters' => [
'password' => 'mypass', // ✅ 正确：全局生效
'database' => 0,
],
'nodes' => [
['host' => '192.168.1.10', 'port' => 7000],
],
]);
填在 PHPStorm 数据源里的 Password 字段或 requirepass 配置项，对集群完全无效——那些字段只用于单机 AUTH 流程，Predis 根本不读。
真正要验证集群连通性，别信 PHPStorm 的 Test Connection 按钮；直接写一行 php -r "require 'vendor/autoload.php'; \$c = new Predis\Client(['nodes'=>['tcp://127.0.0.1:7000']]); echo \$c->ping();" 在终端跑。能 ping 通，再进 PHPStorm 调试才靠谱。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
