Redis 与缓存 / 知识点

Redis 故障排查手册

手册条目

通过进程、端口和 PING 响应快速判断 Redis 服务是否正常运行。

检查 Redis 服务是否存活

应用报连接拒绝、超时或缓存不可用时,依次确认进程、监听端口和 PING 响应。只有三层都正常,才能判断指定 Redis 端点真正可用;只看到进程不代表已成功监听或能处理请求。

命令定位

先核对应用实际使用的主机、端口、TLS 和认证方式。默认数据端口是 6379,生产环境可能已修改;容器或 Kubernetes 场景应在应用所在网络位置执行,避免“宿主机可通、应用侧不通”的误判。

主检查

bash
HOST="${HOST:-127.0.0.1}"
PORT="${PORT:-6379}"

printf '== process ==\n'
ps -eo pid,args | grep -E '[r]edis-server|[r]edis-sentinel' || true

printf '== listen ==\n'
ss -lntp 2>/dev/null | awk -v port="$PORT" '$4 ~ (":" port "$")'

printf '== ping ==\n'
redis-cli -h "$HOST" -p "$PORT" -t 3 --raw PING

预期输出

text
== process ==
<PID> /usr/bin/redis-server 127.0.0.1:6379
== listen ==
LISTEN 0 511 127.0.0.1:6379 0.0.0.0:* users:(("redis-server",pid=<PID>,fd=<FD>))
== ping ==
PONG

<PID>、<FD> 是动态值。进程行表示 Redis 已启动,监听行表示目标端口已建立套接字,PONG 表示 TCP 连接和 Redis 协议均正常。

输出读取

NOAUTH Authentication required. 说明服务存活但请求未认证,应通过受保护的 REDISCLI_AUTH 重试。Connection refused 通常表示目标可达但端口未监听;Connection timed out 更偏向路由、防火墙、网络策略或实例严重阻塞;主机名解析错误则先检查 DNS 和服务发现。

若进程存在但没有监听,检查启动日志、配置语法、端口占用和文件权限。若端口存在但 PING 超时,再查看 CPU、内存、连接数、慢命令和持久化阻塞,不要立即把问题归因于网络。

风险与边界

在命令行使用 redis-cli -a <PASSWORD> 会把密码暴露在 shell 历史或进程参数中;安全替代是从密钥系统注入 REDISCLI_AUTH,检查后执行 unset REDISCLI_AUTH。高频循环 PING 会持续创建连接并放大故障实例压力,应使用单次探测或带退避的监控。

仅凭进程名执行 kill -9 可能中断写入、触发故障转移并增加数据丢失风险。先确认节点角色、持久化和切换策略,再通过服务管理器做受控重启。

排障清单

  1. 核对应用连接地址、端口、TLS 和认证参数。
  2. 确认 Redis 进程或容器状态,并查看最近启动日志。
  3. 检查监听地址是否允许当前来源访问。
  4. 从应用同一网络位置执行 PING。
  5. 按认证失败、拒绝连接、超时或 DNS 错误进入对应分支。

兼容性提示:精简镜像可能没有 ss,可改用 netstat -lntp 或 lsof -nP -iTCP:<PORT> -sTCP:LISTEN。

目录与阅读设置

记录一个想法

Redis 故障排查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通