Kubernetes环境下Redis Pod与Python Pod只读Slave报错问题求助

1. 确认Redis实例的实际运行角色 #

别只看配置文件，直接进入Redis Pod查看实时状态：

kubectl exec -it <redis-pod-name> -- redis-cli info replication

重点看输出里的role字段，如果显示slave，说明配置未生效。此时需要：

• 检查容器启动命令：StatefulSet的启动参数如果带了--slaveof <master-ip> <port>，会直接覆盖ConfigMap里的slaveof no one配置。
• 验证配置文件加载情况：进入Pod查看实际生效的配置文件，比如cat /etc/redis/redis.conf，确认slaveof no one和replica-readonly no确实存在。如果不存在，检查ConfigMap的挂载路径、权限是否正确。

2. 排查Python Pod的Redis连接目标 #

有可能Python Pod被Service路由到了slave实例：

• 在Python Pod内执行命令，确认连接的Redis实例角色：

kubectl exec -it <python-pod-name> -- redis-cli -h <redis-service-name> info replication

如果连接到的是slave，需要调整Service路由逻辑：

• 若使用Headless Service，给Redis master节点打专属标签，修改Service的selector只匹配该标签，确保流量仅指向master。
• 或者让Python代码直接指定master Pod的域名（例如redis-0.redis-headless.default.svc.cluster.local），避免路由到slave节点。

3. 验证Redis运行时配置 #

有时候配置文件修改后未实时生效，直接用Redis命令查看当前生效的配置：

kubectl exec -it <redis-pod-name> -- redis-cli config get replica-readonly
kubectl exec -it <redis-pod-name> -- redis-cli config get slaveof

如果输出不是"no"和""（slaveof为空表示当前是master），可以临时执行命令修正，再验证问题是否解决：

kubectl exec -it <redis-pod-name> -- redis-cli config set replica-readonly no
kubectl exec -it <redis-pod-name> -- redis-cli slaveof no one

临时修改生效后，要确保Pod启动时能加载正确配置，比如检查ConfigMap挂载逻辑，或在启动命令中直接追加这些配置参数。

4. 清理旧数据避免角色自动恢复 #

如果Redis之前是slave角色，重启后可能会从数据卷的旧文件（如replica.conf、dump.rdb）恢复slave状态：

• 备份数据后，删除Redis Pod的PersistentVolumeClaim，再重新创建Pod：

kubectl delete pvc <redis-pvc-name>
kubectl delete pod <redis-pod-name>

Pod重启后再次检查角色，确认已切换为master。

5. 检查Python客户端连接配置 #

部分Python Redis客户端会默认路由到slave节点，检查代码中的连接参数：

• 比如redis-py如果设置了readonly=True，会强制连接slave，需移除该参数：

# 错误写法
r = Redis(host="redis-service", port=6379, readonly=True)
# 正确写法
r = Redis(host="redis-service", port=6379)

若使用连接池或哨兵模式，也要确认未开启只读相关配置。

内容的提问来源于stack exchange，提问作者shivaniverma6991