| 根因 | 写流量路由到副本 |
|---|---|
| 排查 | 客户端配置与拓扑一致性 |
| 修复 | 更新连接地址或走代理层 |
示例
示例
redis-cli INFO replication | Select-String role主从切换后出现 READONLY，优先核对客户端是否仍指向旧主。
本包目录（421 条）
数据结构与选型42 条持久化56 条主从与哨兵51 条Cluster 集群44 条内存与管理99 条
性能与排障129 条
- SCAN 游标遍历替代 KEYS
- HSCAN/SSCAN/ZSCAN 遍历容器元素
- TTL 批量检查与过期状态判定
- O(N) 命令雷区清单
- 常见错误信息速查表
- 读懂慢日志条目字段
- INFO stats 关键字段速查
- 延迟尖刺排查清单
- io-threads：多线程网络 IO
- 性能监控指标采集清单
- INFO 段落速览与取值清单
- 慢查询定位流程
- 延迟事件类别速查
- redis-benchmark 参数详解
- MISCONF 错误：持久化失败被禁写
- 日志关键词与处置方向
- SLOWLOG GET：读取慢查询日志
- slowlog-log-slower-than 阈值设定
- latency-monitor-threshold 开启延迟监控
- redis-cli --bigkeys 键规模扫描
- CLIENT LIST 连接全景
- INFO commandstats 命令调用画像
- 大 key 检测：常用三招
- tcp-backlog 与连接积压
- redis-benchmark 快速压测
- memtier_benchmark 复杂负载模拟
- MULTI/EXEC 事务与执行语义
- WATCH 乐观锁实践
- 阻塞命令与等待语义
- 单线程模型与瓶颈判读
- CPU 高的排查路径
- 连接风暴的处理
- BUSY：脚本超时占用
- 容量压测实施方法
- 从日志定位问题的顺序
- 内核 backlog：somaxconn 与 syn 队列
- 延迟来源分层总图
- 延迟跟踪配置：latency-tracking
- 集群延迟来源与治理
- LATENCY LATEST：最新延迟事件
- CLIENT KILL 断开问题连接
- CLIENT PAUSE 暂停客户端命令
- MONITOR 的使用与风险
- INFO latencystats 命令延迟百分位
- KEYS 的替代路径
- HGETALL 大 hash 的读法
- 大 key 的安全删除
- 管道压测与业务口径
- 管道（pipeline）批量提交原理
- CLUSTERDOWN：集群不可用
- 性能告警阈值设计
- 变更发布检查清单
- 故障处理流程与分级
- COMMAND 系列：命令元信息查询
- INFO errorstats：错误分类计数
- 压测的协调遗漏与真实延迟
- 服务节点系统指标清单
- 客户端库选择与常见坑
- 重试与退避：故障期的自保
- 故障演练：切换与宕机剧本
- 集合运算与位图操作的规模风险
- 健康检查设计要点
- 上线前性能预检清单
- 集群模式压测要点
- redis-cli --intrinsic-latency 系统基线
- redis-cli --memkeys 内存视角扫描
- redis-cli --hotkeys 热点键分析
- redis-cli --pipe 高速批量导入
- INFO cpu 与子进程 CPU
- LRANGE 大范围读取的替代
- SMEMBERS 大集合的替代
- SORT 的复杂度与用法约束
- maxclients 连接上限
- timeout 回收空闲连接
- unixsocket：本机调用的低延迟通道
- 网络层排查：ping、mtr 与抓包
- 系统工具速查：top/iostat/vmstat
- perf 定位进程内热点
- READONLY 错误：写错了实例
- NOSCRIPT：脚本缓存未命中
- MASTERDOWN 与 TRYAGAIN：重试类错误
- 连接使用 IP 直连，规避解析风险
- 指标采集频率的取舍
- 压测预热与冷启动偏差
- 连接复用：省下的是握手成本
- LB 空闲超时与连接存活协同
- 热点分布建模：Zipf 而非全随机
- 重启后的冷启动与流量涌入
- 跨机房访问与就近部署
- TLS 加密的连接与吞吐成本
- 慢日志定期归档与分析
- MGET/MSET 合并往返
- 超时设计：连接、读写与命令
- 背压：下游慢时的自我保护
- 运维手册（Runbook）要素
- 复盘方法与行动项跟踪
- 内核网络缓冲区与大数据流量
- TCP_NODELAY 与 Nagle 延迟
- 尾延迟治理手段清单
- 缓存预热：重建命中率
- 读懂压测的延迟分布表
- 应用启动的连接预热
- slowlog-max-len 缓冲区长度
- LATENCY HISTORY 追踪单个事件
- LATENCY DOCTOR：延迟体检报告
- redis-cli --latency 往返延迟测量
- CLIENT NO-EVICT 保护关键连接
- CLIENT NO-TOUCH 读取不扰动热度
- INFO clients 连接指标
- tcp-keepalive 与死连接清理
- RESP3 与 HELLO 握手
- 后台线程（bio）都做什么
- LOADING 错误：加载窗口的重试
- hz：定时任务频率
- 性能基线：建立与对比
- 性能回归检测方法
- 延迟百分位：p99 才是体验
- max 延迟指标的误导性
- CPU steal 与虚拟化延迟
- 时钟同步与时间戳对齐
- MTU 与分片重传问题
- redis-cli --latency-history 长观测
- redis-cli --lru-test 缓存负载模拟
- SLOWLOG 维护命令：LEN 与 RESET
- LATENCY RESET 清理采样
- redis-cli --stat 实时状态面板
- CLIENT INFO 单连接详情
- dynamic-hz：自适应频率
- CLIENT UNPAUSE 解除暂停
READONLY 错误：写错了实例
READONLY 表示向副本发起了写命令：检查路由配置与故障切换后的主从指认，切换窗口内客户端配置未更新是常见原因。
易错点
- 把写错误重试到同一副本，永远无法成功
- 切换后客户端配置更新依赖人工，窗口内持续报错
数据来源与参考
- Redis 官方文档：READONLY 错误说明