目录

一、问题描述

二、问题原因

三、解决方案

1. 检查连接的 Redis 节点

2. 强制连接到主节点

3. 启用 Redis 集群模式（如果适用）

4. 确保主节点是可写的

5. 检查 Redis 角色切换日志

四、总结

---

一、问题描述

在使用 Redis 进行数据操作时，如果你遇到了如下错误：

redis.exceptions.ReadOnlyError: You can't write against a read only replica

这个错误提示你尝试在一个只读的 Redis 实例（副本节点）上进行写操作。在 Redis 集群或主从复制（Master-Slave）模式中，通常只有主节点（Master）允许写操作，而从节点（Replica/Slave）是只读的。出现这个错误意味着你正尝试在从节点上执行写操作，这会导致操作失败。

二、问题原因

导致该错误的主要原因如下：

1. 连接到了只读副本：你的客户端可能连接到了一个从节点（Replica），而从节点默认情况下是只读的，无法进行写操作。
2. 主从节点角色切换：在某些情况下，由于网络分区、主节点故障等原因，Redis 集群可能会进行主从角色切换，导致原来的主节点变为从节点。
3. 负载均衡配置问题：如果你使用了负载均衡（如 Keepalived 或 HAProxy）来连接 Redis 集群，负载均衡可能选择了一个从节点作为当前连接节点。

三、解决方案

1. 检查连接的 Redis 节点

首先，你需要确认当前连接的节点是否是主节点（Master）。你可以通过以下命令检查节点角色：

redis-cli INFO replication

输出中，如果当前节点是主节点，会看到类似如下信息：

role:master

如果是从节点，则会看到：

role:slave

如果出现 Could not connect to Redis at 127.0.0.1:6379: Connection refused 错误通常意味着 Redis 服务没有在默认的本地 IP（127.0.0.1）和端口（6379）上运行，或者 Redis 服务未启动。

# 如果你确认 Redis 监听在其他 IP 或端口，请在 redis-cli 命令中指定正确的 IP 和端口。
# 例如，如果 Redis 在 192.168.1.100 上的端口 6380 运行，可以使用：

redis-cli -h 192.168.1.100 -p 6380 INFO replication

2. 强制连接到主节点

确保你的 Redis 客户端连接的是主节点的 IP 地址和端口，而不是从节点。常见的做法是直接指定主节点的 IP：

import redis
# 使用 Redis 主节点的 IP 地址和端口
r = redis.StrictRedis(host='主节点IP', port=6379, db=0)

3. 启用 Redis 集群模式（如果适用）

如果你在使用 Redis 集群模式，你需要启用集群连接模式，这样客户端可以正确识别主从节点并选择合适的节点进行操作。

from rediscluster import RedisCluster
# 连接到 Redis 集群
startup_nodes = [{"host": "集群节点IP1", "port": "7000"},
                 {"host": "集群节点IP2", "port": "7001"}]
rc = RedisCluster(startup_nodes=startup_nodes, decode_responses=True)

4. 确保主节点是可写的

在某些故障恢复场景中，Redis 主节点可能被设置成了只读模式。可以通过以下命令强制解除只读模式：

redis-cli -h 主节点IP -p 端口 CONFIG SET slave-read-only no

5. 检查 Redis 角色切换日志

可以通过检查 Redis 的日志来确认是否发生了角色切换：

tail -f /var/log/redis/redis-server.log

如果发现有故障或角色切换的记录，建议修复 Redis 集群或重新配置主节点。

四、总结

redis.exceptions.ReadOnlyError 错误通常是由于写操作指向了只读的从节点引起的。为了解决这个问题，必须确保写操作只在主节点进行。如果你的系统中使用了 Redis 集群或负载均衡，建议使用支持主从切换的客户端库来确保高可用性和正确性。