PHPStorm 不支持 Redis 集群调试，Database Tool 仅兼容单节点协议，无法处理 MOVED/ASK 重定向；应改用 phpredis 扩展配合断点调试，并通过 redis-cli 交叉验证 key、TTL 及序列化行为。
PHPStorm 无法直接连接 Redis 集群做调试，但配合 phpredis 扩展进行单节点缓存调试是完全可行的——前提是别误用数据库工具窗口连集群，也别指望它自动帮你查 key 命中率或 TTL。
PhpStorm 的 Database Tool 窗口不支持 phpredis 调试
Database Tool → Data Source → Redis 这个入口只认单机协议，它压根不走 phpredis 扩展，而是用自己封装的简易客户端。你填了 127.0.0.1:7000，它就真去连这个地址；填集群地址列表？它只会挑第一个连，其余全丢弃。更关键的是：它不会执行 INFO、TTL 或 KEYS 之外的命令，也没法看到 setex 实际写入的过期时间是否生效。
所以别在 Database Tool 里折腾缓存调试——它连 $redis->setex('user:1001', 3600, '...') 写进去的数据都可能显示“key not found”，因为它的刷新逻辑和 phpredis 不同步，且不支持 SELECT db 切库（除非你硬编码进 URL，但它不解析）。
用 phpredis + 断点 + redis-cli 验证缓存行为
真正有效的调试路径是：让 PHP 脚本走 phpredis 扩展操作缓存，在关键行加断点，再用终端工具交叉验证。
立即学习“PHP免费学习笔记（深入）”；
- 确保
extension=redis.so已启用，php -m | grep redis能输出redis - 连接后立刻加断点：
$redis = new Redis(); $redis->connect('127.0.0.1', 6379);，停住后在 Variables 面板确认$redis是Redis实例，不是False或空对象 - 写缓存时带
setex而非set，并在下一行加断点：$redis->setex('cache:user:1001', 600, json_encode($data));，然后立刻切到终端执行：redis-cli get "cache:user:1001"和redis-cli ttl "cache:user:1001"，看值和剩余时间是否匹配 - 读缓存前先用
$redis->exists('cache:user:1001')判断，别直接get后判空——否则命中失败和 key 不存在会表现一致，难以区分是逻辑问题还是缓存没写进去
序列化数据缓存必须手动处理，IDE 不会提醒你
phpredis 存数组/对象必须显式 serialize()，取出来要 unserialize()。IDE 不会在你写 $redis->set('cfg', ['host' => 'x']) 时报错，但运行时存进去的是字符串 "Array"，读出来就是废数据。
容易踩的坑：
- 漏掉
serialize()导致存进去的是Array字符串，get()返回后json_decode()失败 - 反序列化前没校验字符串长度或前缀，遇到被截断或损坏的缓存内容直接
unserialize()报致命错误 - 缓存对象含闭包或资源句柄（如
mysqli），serialize()会静默失败或产生不可还原数据
建议统一用 json_encode(..., JSON_UNESCAPED_UNICODE) + json_decode(..., true) 替代 serialize/unserialize，更安全、跨语言、IDE 变量监视里也看得清。
缓存 Key 设计不当会导致调试时“明明写了却读不到”
Key 名含变量但没拼对，是最隐蔽的调试盲区。比如写的是 $redis->setex("user_{$id}_profile", 3600, ...)，读的时候却用了 $redis->get("user_{$id}:profile")（中间是下划线 vs 冒号）——IDE 不会标红，断点里 get 返回 false，你以为是缓存失效，其实是 key 根本不匹配。
实操建议：
- 把 key 拼接逻辑抽成独立函数，例如
cacheKey('user', $id, 'profile')，避免散落在多处 - 在断点处右键 Variables → “Copy Value” 粘贴出来，和
redis-cli keys "user*"结果比对 - 开发期开启
redis-cli monitor（注意生产禁用），实时看 PHP 真正发了哪些命令、key 是什么
复杂场景下，哪怕只是改了一个字符，key 就彻底不同——这不是 Redis 的问题，是你调试时最该盯住的第一环。
