首页/数据/数据库速查/连接故障排查:连不上与超时
Redis 运维与场景124 条

连接故障排查:连不上与超时

「连不上 Redis」的排查顺序:网络与端口 -> 服务端进程/日志 -> 连接数与 maxclients -> 认证/TLS/保护模式 -> 客户端池与防火墙;错误信息先分类再动手。

数据库速查数据更新于 2026-10-13

连接故障排查是什么

连不上实例时最忌讳直接重启。按层排查最快:先看网络与端口是否可达,再看服务端进程与日志,接着看连接数是否打满,然后核对认证、加密与保护模式,最后回到客户端连接池与防火墙规则。错误信息先分类,动作才不会发散。

基本信息

网络层连通性测试、端口探测
服务端进程状态、监听地址、日志尾部
连接容量当前连接数、被拒绝连接数、最大连接数
认证与安全密码、账号权限、加密要求、保护模式与监听绑定
客户端连接池上限、超时、重试策略

错误信息对照

  • 连接被拒绝:进程未启动、端口不对或防火墙直接拒绝
  • 超时:网络阻断、连接队列满或实例卡住
  • 认证失败:密码错误或账号权限不足
  • 加载中:实例正在加载持久化文件,等待完成即可
  • 连接数达上限:需要排查连接泄漏或扩容连接数

分层排查

分层排查
# 第一层:网络与端口
ping -c 3 10.0.0.5
redis-cli -h 10.0.0.5 -p 6379 -t 2 PING
nc -vz 10.0.0.5 6379
# 第二层:服务端视角
redis-cli INFO clients | grep -E "connected_clients|rejected_connections"
redis-cli CONFIG GET maxclients
redis-cli CONFIG GET bind protected-mode
# 第三层:日志
tail -100 /var/log/redis/redis-server.log

现象与处理

现象常见原因处理动作
连接被拒绝进程未启动、端口错、防火墙拒绝查进程、监听端口与安全组
连接超时网络阻断、等待队列满、实例卡住查延迟指标与背压情况
认证失败密码或账号配置不对核对密码与账号权限
实例加载中正在载入持久化文件等待加载完成再重试
连接数达上限连接泄漏或短连接过多清理异常连接并评估容量
远程无法连接监听地址限制或保护模式开启核对绑定地址与保护模式配置
默认配置下实例只监听本机地址并开启保护模式:远程连不上时先核对这两项,再怀疑网络。
为排查方便临时放开监听地址与关闭保护模式后忘记改回:等于把实例暴露出去,必须列入变更回收清单。

易错点

  • 只盯客户端报错:服务端被拒绝连接数与等待队列才是根因线索
  • 远程连不上先改网络:监听地址与保护模式这两项检查成本最低,应该最先看
  • 排查期间关闭认证或保护模式:临时放开后忘记恢复,造成暴露
  • 重启实例作为第一手段:既丢失现场,又可能让依赖缓存的业务整体雪崩

数据来源与参考

  • Redis 官方文档: 连接排查
  • Redis 官方文档: maxclients

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌