Redis Sentinel 故障转移实战：从配置到生产级高可用部署

它解决什么问题 / 适用场景

Redis Sentinel 解决的核心问题是：当 Redis 主节点宕机时，如何自动完成故障转移，让系统继续可用。它适用于需要高可用性但不需要数据分片的 Redis 部署场景，典型场景包括：

• 微服务架构中的会话状态存储，确保服务在 Redis 实例故障时仍能保持会话连续性
• 大模型应用的缓存层，避免模型服务因缓存故障而中断
• 与支持 Sentinel 的客户端库（Jedis、Lettuce、StackExchange.Redis）配合使用
• 需要快速故障恢复但数据量未达到 Redis Cluster 分片门槛的场景

Sentinel 不提供数据分片能力，这是它与 Redis Cluster 的核心区别。如果你的数据量超过单机内存上限，应直接使用 Cluster。

安装与快速上手

Redis Sentinel 是 Redis 发行版的一部分，无需额外安装。启动 Sentinel 的命令是：

BASH
redis-server /path/to/sentinel.conf --sentinel

一个最小可用的 sentinel.conf 配置如下：

CONF
# 监控主节点 mymaster，IP 为 127.0.0.1，端口 6379，法定人数 2
sentinel monitor mymaster 127.0.0.1 6379 2
sentinel down-after-milliseconds mymaster 5000
sentinel failover-timeout mymaster 60000
sentinel parallel-syncs mymaster 1

启动后，使用 redis-cli -p 26379 连接 Sentinel，执行 SENTINEL masters 验证状态。

生产环境至少需要 3 个 Sentinel 实例，且应部署在不同物理机或可用区。每个实例的 sentinel.conf 中 sentinel monitor 配置必须一致。

核心配置 / 参数说明

以下参数是 Sentinel 行为的关键控制点，配置错误会直接导致故障转移失败或数据丢失。

关键注意事项：

• sentinel.conf 文件必须可写，否则 Sentinel 无法保存状态（如主节点地址变更）。
• 端口 26379 需开放给其他 Sentinel 实例，用于互相通信和选举。
• 在 Docker 或 NAT 环境下，必须配置 sentinel announce-ip 和 sentinel announce-port，否则自动发现会失败。

与同类方案对比

亮点：Sentinel 的优势在于原生集成、配置简单、支持客户端服务发现和配置动态更新。对于不需要分片的场景，它是比 Cluster 更轻量的选择。

生产环境实践与注意事项

部署架构要求

1. 至少 3 个 Sentinel 实例，且部署在不同物理机或可用区，避免单点故障导致脑裂。
2. 奇数个 Sentinel，quorum 通常设为 N/2 + 1（例如 3 个实例时 quorum=2）。
3. 主从复制架构：至少 1 个主节点 + 2 个从节点，确保故障转移后有可用副本。

数据丢失防护

由于 Redis 使用异步复制，故障时可能丢失已确认写入。以下配置可降低风险：

CONF
# 在主节点配置中（redis.conf）
min-replicas-to-write 1
min-replicas-max-lag 10

这要求至少 1 个从节点同步延迟不超过 10 秒，否则主节点拒绝写入。但请注意，这会降低写入可用性。

安全性配置

CONF
# 在 sentinel.conf 中
requirepass your-strong-password
masterauth your-strong-password

同时限制网络访问：仅允许 Sentinel 实例和客户端 IP 访问端口 26379 和 6379，启用 TLS 加密（如果 Redis 版本支持）。

定期测试故障转移

不要等到生产故障才发现配置错误。使用以下命令手动触发故障转移测试：

BASH
redis-cli -p 26379 SENTINEL failover mymaster

观察日志确认流程正常，然后检查客户端是否能自动连接到新主节点。

常见报错与排查

错误 1：Redis Sentinel 无法启动：配置文件不可写或路径错误

报错信息：FATAL CONFIG FILE ERROR 或 Can't open the config file

解决：确保 sentinel.conf 文件存在且当前用户有写入权限，使用绝对路径：

BASH
redis-server /etc/redis/sentinel.conf --sentinel

错误 2：Sentinel 无法发现其他 Sentinel 实例：端口未开放或 IP 配置错误

报错信息：SENTINEL sentinels mymaster 返回空列表

解决：

1. 检查防火墙规则，确保 TCP 26379 端口开放：

   BASH
   firewall-cmd --add-port=26379/tcp --permanent && firewall-cmd --reload
   

2. 在 sentinel.conf 中手动指定其他 Sentinel 的 IP 和端口：

   CONF
   sentinel known-sentinel mymaster 192.168.1.2 26379
   sentinel known-sentinel mymaster 192.168.1.3 26379
   

错误 3：故障转移失败：Sentinel 无法选举领导者

报错信息：日志中出现 Unable to failover, no majority 或 failover-abort-not-elected

解决：

• 确保 Sentinel 实例数量为奇数且至少 3 个
• 检查 quorum 配置（通常设为 N/2+1）
• 验证网络连通性：redis-cli -h <other-sentinel-ip> -p 26379 PING
• 确保多数 Sentinel 可互相通信

错误 4：客户端连接失败：Sentinel 返回的 master 地址不可用

报错信息：客户端报 Connection refused 或 Cannot get master address from Sentinel

解决：

1. 检查 sentinel monitor 配置中的 IP 和端口是否正确
2. 使用命令验证返回地址：

   BASH
   redis-cli -p 26379 SENTINEL get-master-addr-by-name mymaster
   

3. 如果使用 Docker，配置 announce 参数：

   CONF
   sentinel announce-ip <宿主机IP>
   sentinel announce-port <映射后的端口>
   

常见问题 FAQ

Q: 在 Docker 环境中部署 Redis Sentinel 需要注意哪些问题？

A: Docker 的端口映射会破坏 Sentinel 的自动发现机制。解决方案：

1. 使用 host 网络模式（--net=host）避免端口映射
2. 或配置 sentinel announce-ip 和 sentinel announce-port 为宿主机 IP 和映射后的端口
3. 确保所有 Sentinel 实例的 announce 配置一致
4. 使用 docker-compose 时，设置 network_mode: host 或手动指定 IP

Q: 如何确保 Redis Sentinel 故障转移时不丢失数据？

A: 由于 Redis 使用异步复制，完全避免数据丢失较困难。但可采取以下措施：

1. 设置 min-replicas-to-write 1 和 min-replicas-max-lag 10，确保至少一个副本同步
2. 使用 WAIT 命令等待副本确认
3. 配置 sentinel down-after-milliseconds 为较小值（如 5000ms）以快速检测故障
4. 定期备份 RDB/AOF 文件
5. 对于关键数据，考虑使用 Redis Cluster 或外部持久化方案

Q: 如何监控 Redis Sentinel 的健康状态？

A: 1) 使用 SENTINEL master <master-name> 命令查看主节点状态；2) 使用 SENTINEL replicas <master-name> 查看副本状态；3) 使用 SENTINEL sentinels <master-name> 查看其他 Sentinel 状态；4) 集成 Prometheus 和 Grafana，使用 redis_exporter 收集 Sentinel 指标；5) 设置告警规则：当 Sentinel 数量少于 3、主节点切换次数异常、或副本同步延迟过高时触发通知。