Redis 与缓存 / 系统课时

理解 Sentinel 客户端连接

理解 Sentinel 客户端连接

本课说明客户端如何通过多个 Sentinel 查询当前主节点,再直接连接 Redis 完成读写,并在故障转移后重新发现新地址。

学习目标

  • 区分 Sentinel 连接与 Redis 数据连接
  • 理解发现、连接和故障后重连流程
  • 正确配置多个 Sentinel 地址与重试边界

连接流程

Sentinel 只负责监控和地址发现,不代理普通 Redis 命令。客户端先向任一可用 Sentinel 查询逻辑主节点名 mymaster,获得当前地址后,再建立到 Redis 主节点的数据连接。

故障转移期间,旧连接可能被关闭,也可能连到已经变成副本的旧主。支持 Sentinel 的客户端会废弃失效连接、重新查询地址,并把后续命令发送到新主节点。

Sentinel 客户端发现流程

使用 Sentinel 感知客户端

下面使用 redis-py 演示完整连接。脚本配置三个 Sentinel 地址,并通过 master_for 获取会自动重新发现主节点的连接代理。

python
from redis.sentinel import Sentinel

SENTINELS = [
    ("127.0.0.1", 26379),
    ("127.0.0.1", 26380),
    ("127.0.0.1", 26381),
]

sentinel = Sentinel(
    SENTINELS,
    socket_timeout=2.0,
    decode_responses=True,
)

master = sentinel.master_for(
    "mymaster",
    socket_timeout=2.0,
)

master.set("client:discovery", "ok")
print(master.get("client:discovery"))

host, port = sentinel.discover_master("mymaster")
print(f"{host}:{port}")

将代码保存为 sentinel_client.py,安装依赖并运行:

bash
python -m pip install redis
python sentinel_client.py

预期输出:

text
ok
127.0.0.1:<MASTER_PORT>

<MASTER_PORT> 是 Sentinel 当前返回的主节点端口,可能是 6379,也可能在故障转移后变为 6380。重新运行脚本时无需修改固定地址。

处理认证与超时

开启认证时,需要区分两条链路:客户端访问 Sentinel 的认证信息,以及客户端访问 Redis 数据节点的认证信息。两者的用户名和密码可能不同,不能只配置一套凭据。

连接超时和命令超时也应分别设置。超时过长会延迟故障感知,过短则会在网络轻微抖动时产生大量误失败,应结合部署网络和业务延迟目标调整。

控制自动重试

切换窗口内可能出现超时、连接关闭或 READONLY。客户端库可以帮助重新发现,但无法判断业务命令是否已经在旧主执行成功。

只有天然幂等的读取,或带唯一请求号、幂等键和结果查询能力的写入,才适合自动重试。支付、扣款和库存扣减等操作必须先解决重复执行问题,再开启重试。

验证客户端恢复

验证时先成功执行一次脚本,再触发 Sentinel 故障转移,最后不修改代码直接重新运行。若仍能写入并读取 ok,说明客户端已经通过逻辑主节点名发现了新主。

同时应观察应用日志和连接池指标,确认旧连接被清理,重试次数受限,并且恢复过程没有持续访问旧主。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 Sentinel 客户端连接

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通