当前位置：首页 > 问答 > 正文

Redis连不上主机到底是啥原因，排查各种可能导致连接失败的情况

（信息源：Redis官方文档 Troubleshooting 章节，Stack Overflow 社区常见问题汇总，以及常见的网络与系统管理知识）

当你兴致勃勃地想用Redis大展拳脚,结果命令行或者程序里蹦出一个连接错误，这确实很让人头疼，Redis连接不上主机，就像你到了朋友家门口却发现钥匙不对，原因可能出在钥匙本身、门锁、或者你甚至找错了楼，下面我们就来把各种可能性捋一遍，从最简单、最常见的开始，一步步深入到不那么常见的情况。

第一步：检查最基本的三要素——IP地址、端口、密码

这是最应该先检查的地方,八成以上的连接问题都出在这里。

主机地址（IP/Hostname）对不对？ 你是不是写错了？比如把 localhost 写成了 localhos，或者把服务器的内网IP（如 168.1.10）误当成公网IP来用了，如果你用的是云服务（比如阿里云、腾讯云），要特别注意：服务器通常有内网IP和公网IP，从你自己的电脑连接，必须使用公网IP。（信息源：云服务商常见问题文档）
端口号对不对？ Redis默认端口是 6379，有没有可能你的Redis服务配置了别的端口？比如为了安全或者多实例运行，改成了 6380 之类的，检查一下Redis的配置文件 redis.conf 里的 port 设置。
密码认证过了吗？ 如果你的Redis服务器设置了密码（通过配置文件里的 requirepass 选项），那么连接时必须提供密码，在命令行中，可以用 -a 参数，redis-cli -a yourpassword，在程序中，则需要在连接配置里填上密码，如果密码错误，连接会被服务器直接拒绝。

第二步：看看Redis服务自己“醒了没”

如果连接信息没错,那下一个问题就是：Redis服务本身在正常运行吗？

Redis服务启动了吗？ 登录到Redis所在的主机上，用简单的命令检查一下，在Linux上，可以用 systemctl status redis 或者 ps aux | grep redis 看看有没有Redis进程在跑，如果没启动，当然连不上。
Redis是否只接受本地连接？ 这是另一个非常常见的坑，Redis的默认配置是只允许本机（0.0.1）连接，这是出于安全考虑，如果你想从其他电脑连接，必须修改配置文件 redis.conf，找到 bind 这一行，默认可能是 bind 127.0.0.1，你需要把它注释掉（行首加），或者改成 bind 0.0.0.0（允许所有IP连接），或者更安全地，只绑定到你服务器的内网或公网IP。重要： 修改此配置后，必须重启Redis服务才能生效。（信息源：Redis配置文件注释说明）
保护模式是否阻止了你？ 从Redis 3.2版本开始，引入了一个“保护模式”（protected mode），当Redis没有设置密码，并且没有使用 bind 指令明确绑定到非本地地址时，它会自动进入保护模式，只接受本地回环地址（127.0.0.1和::1）的连接，如果你从外网连接一个既无密码又未正确配置 bind 的Redis，就会被这个机制挡住，解决方法就是上面提到的：要么设置密码，要么正确配置 bind 指令。

第三步：网络层面的“千山万水”

如果服务本身没问题,那可能就是网络通路被阻断了，这通常是运维层面需要排查的问题。

防火墙是否放行了？ 这是拦截外部连接的“常客”，无论是服务器本身的操作系统防火墙（如Linux的iptables或firewalld），还是云服务商提供的安全组（Security Group） 规则，都需要为Redis的端口（默认6379）设置“入站（Inbound）”允许规则，你需要确认规则允许你的客户端IP地址访问6379端口，在阿里云/腾讯云的安全组里，要添加一条规则，授权来源为你电脑的IP或IP段，协议端口为TCP:6379。
云服务的网络配置问题。 特别是在云环境下，除了安全组，还可能存在网络ACL（访问控制列表） 或子网路由等问题，导致网络不通，确保你的Redis实例所在的子网和路由配置允许外部访问。
IP地址能否ping通？ 虽然有时候服务器禁用了ICMP（ping请求）导致ping不通但端口可能通，但如果能ping通，至少说明网络底层是连通的，如果ping都ping不通，那问题肯定出在更基础的网络连接上，比如域名解析错误、IP根本不存在或者中间路由有问题。

第四步：一些更深层次或隐蔽的原因

如果以上都排除了,那就要考虑一些更特殊的情况。

最大连接数满了？ Redis有一个 maxclients 配置，用于限制同时连接的最大客户端数，如果连接数达到上限，新的连接请求就会被拒绝，你可以通过Redis的INFO命令查看当前连接数，不过这种情况在生产环境负载高时可能出现，对于刚搭建的环境比较少见。
客户端库的配置或Bug。 有时候问题不出在服务端，而在客户端，比如你使用的编程语言连接库（如Jedis for Java， redis-py for Python）版本过旧或有Bug，或者连接配置方式不对（比如设置了连接超时时间太短），尝试更新客户端库到最新版本，或者换一个客户端工具（比如用官方的redis-cli）测试一下，可以帮助判断问题出在哪一端。
Redis服务器资源耗尽。 在极少数情况下，如果服务器内存耗尽、CPU负荷极高，也可能导致Redis无法响应新的连接请求，可以通过系统监控工具（如top）查看服务器资源使用情况。

总结一下排查思路：

就像一个标准的侦探流程,先从自身找原因（密码、地址对不对），然后查证“受害者”状态（Redis服务是否活着、是否愿意被连接），再调查“案发现场”的环境（防火墙、网络是否通畅），最后考虑一些非常规的意外因素，按照这个顺序，一步步排除，绝大多数Redis连接问题都能找到症结所在。