Redis CLIENT GETREDIR 怎样读取当前连接的失效通知重定向目标
来源:17golang原创
时间:2026-11-18 19:45:03 400浏览 收藏
我第一次用 Redis 的服务器辅助客户端缓存时,最容易误判的一点是:看到缓存失效通知没有到达,就马上去查 key。其实通知可能被重定向到另一个连接,而当前连接只保留了“目标是谁”的状态。这个场景下,CLIENT GETREDIR 就是最直接的入口。
它不负责打开客户端缓存,也不返回缓存内容,只读取当前连接的失效通知重定向目标。返回值为 0 表示没有重定向,-1 表示当前连接没有开启客户端缓存追踪;如果返回正整数,就是通知目标客户端的 ID。
先把当前连接和重定向目标分开
Redis 的客户端缓存通常由一个连接执行读请求,另一个连接接收 key 失效通知。开启追踪的连接可以通过 CLIENT TRACKING ON REDIRECT 指定通知目标。这里有两个容易混淆的 ID:执行查询的连接有自己的 ID,REDIRECT 后面的 ID 则是接收通知的另一个客户端。
CLIENT GETREDIR 查询的是“当前连接配置的重定向目标”,因此必须在你想诊断的那条连接上发送。把命令发到通知接收连接,只能得到接收连接自身的状态,不能反推出业务连接的配置。

在同一连接上读取 CLIENT GETREDIR
排查时先用 CLIENT ID 记下当前连接的身份,再执行 CLIENT GETREDIR。下面的命令只展示命令关系,不代表已经在本文环境中运行。
# 查看当前连接的 ID,作为 REDIRECT 目标的可读参照 redis-cli CLIENT ID # 在同一条连接上读取失效通知重定向目标 redis-cli CLIENT GETREDIR # 需要开启追踪时,才在业务连接上配置重定向目标 redis-cli CLIENT TRACKING ON REDIRECT 42
如果使用连接池,不能把一次调用得到的结果当成整个池的全局状态。每条物理连接都可能有不同的追踪开关和目标,诊断日志应至少带上连接 ID、查询时间和 GETREDIR 返回值。
按三种返回值判断当前状态
CLIENT GETREDIR 的返回值是一个整数,最实用的判断表如下:
| 返回值 | 含义 | 排查动作 |
|---|---|---|
0 | 当前连接没有把通知重定向到其他客户端 | 检查是否使用了 REDIRECT,或是否本来就准备让当前连接接收通知 |
-1 | 当前连接没有启用客户端缓存追踪 | 先确认是否执行了 CLIENT TRACKING ON;不要把 -1 当成目标客户端 ID |
| 正整数 | 通知被重定向到该 ID 对应的客户端 | 在目标连接上用 CLIENT ID 对照,继续检查客户端是否持续读取失效通知 |

这个命令的复杂度是 O(1),所以适合放进一次连接诊断或低频状态采集里。它只回答“通知往哪里重定向”,并不回答目标客户端是否在线、是否正确消费通知,也不列出被追踪的 key。
把结果放回客户端缓存排障流程
我的处理顺序通常是先在业务连接上读 CLIENT GETREDIR,再对照目标连接的 CLIENT ID。返回 -1 时,先修追踪开关;返回 0 时,先确认设计上是否需要 REDIRECT;返回正整数时,再检查目标连接是否被连接池回收、是否有专门的通知读取循环。
如果还需要知道追踪模式、前缀和其他追踪选项,应该查看 CLIENT TRACKINGINFO,不要把 GETREDIR 当成完整配置快照。这样能把“没有失效通知”和“通知发到了另一条连接”区分开,避免在缓存数据层反复排查。
常见问题
返回 -1 是不是表示重定向目标不存在?
不是。-1 表示当前连接没有开启客户端缓存追踪;它不是一个失效的客户端 ID。只有正整数才表示通知重定向目标的客户端 ID。
为什么我在另一条连接上查不到同一个结果?
因为状态绑定在连接上,而不是绑定在 Redis 用户或数据库上。连接池里的每条物理连接都要分别读取,不能用一条连接的返回值代表另一条连接。
归纳起来,CLIENT GETREDIR 最适合做“当前连接的通知去向确认”:先确认连接,再读整数,再根据 0、-1 或正整数选择下一步。至于追踪开关和完整模式,则交给 CLIENT TRACKING 与 CLIENT TRACKINGINFO。
-
117 收藏
-
426 收藏
-
171 收藏
-
113 收藏
-
195 收藏
-
285 收藏
-
365 收藏
-
147 收藏
-
405 收藏
-
427 收藏
-
287 收藏
-
349 收藏
-
357 收藏
-
223 收藏
-
121 收藏
-
283 收藏
-
491 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习