Redis报READONLY:先确认主节点与副本
适用范围:Redis主从、Sentinel或Cluster环境;不同模式的地址发现方式不能混用。
READONLY通常表示写请求到了当前不接受该写入的副本。刚发生故障切换时尤其要检查旧连接池是否仍指向原主节点。它与磁盘只读、MISCONF持久化错误不是同一回事。
从应用实际连接的节点取证
先记录应用配置的主机、端口、部署模式与错误时间,在授权连接中执行:
ROLE
INFO replication
ROLE会报告当前角色;INFO replication用于继续核对复制状态。输出含拓扑信息,只在受控终端查看。没有权限时让管理员提供脱敏结果,不给应用账号追加全套管理权限。[1][2]
不要只在另一个管理入口查到master就宣布应用连接正确,应用可能用的是缓存地址或旧长连接。
按部署模式修正写入目标
固定主从配置:核对当前被选定的主节点,更新应用写地址并按计划重建连接池。Sentinel:客户端应通过正确的主库名称和Sentinel发现主节点。Cluster:使用支持集群槽位与重定向的客户端,不能把随机一个副本当成普通单节点写入口。
读取副本可能有复制延迟。要求写后立即读到新值的业务,应检查读写路由,而不是只解决报错文字。[1]
不关闭副本保护来凑写入成功
不要将副本改成可写,也不要随意执行提升角色的命令。错误写入的内容可能在重新同步后消失,额外主节点还会破坏原来的高可用管理。
若ROLE显示的角色与预期完全不符,先检查是否连错实例、端口映射指向变化、是否发生维护或故障切换。没有证据时不要认定数据被攻击者修改。
重试前确认操作是否幂等
SET固定值与计数增加、队列弹出不是同一风险。连接中断或切换期间,客户端有时无法确定操作是否已经完成;自动重试应由客户端与业务逻辑共同控制,不能盲目重放所有命令。
验收
用专门测试键验证写入和读取,测试键应有合理过期时间且不含客户数据。确认每个应用实例的连接都已经更新,而不是只有一个终端能写。故障切换演练只在有方案的测试环境执行,避免为了验证文档切换生产主从。
继续排查
Redis安装、访问控制与连接验证;Redis报MISCONF:先恢复持久化写入。
技术依据:[1] Redis复制与只读副本;[2] Redis ROLE命令。适用版本见本文说明。