云环境 Redis 白名单配置错误导致无法连接怎么排查

云环境 Redis 连接失败通常因客户端出口 IP 未加入实例白名单或网络隔离导致，需先确认本地公网 IP 并配置云控制台白名单，同时排除 VPC 不通和密码错误问题。

先说结论：云 Redis 默认禁止外部访问，必须将客户端真实出口 IP 加入实例白名单，且确保网络链路（VPC/安全组）畅通。

命令速用版

以下命令用于快速定位网络与服务的连通状态：

curl ifconfig.me

获取客户端当前出口公网 IP，用于配置白名单。

telnet <redis-host> 6379

测试 TCP 端口是否可达，若失败则网络或防火墙拦截。

redis-cli -h <redis-host> -p 6379 -a <password> ping

验证 Redis 服务认证与响应，返回 PONG 表示连接成功。

云厂商 Redis 实例默认开启访问控制，仅允许白名单内的 IP 请求到达服务端口。

连接被拒绝通常是因为请求来源 IP 不在允许的 CIDR 范围内，或者实例与客户端不在同一 VPC 导致网络隔离。部分实例还强制要求密码认证或 SSL 加密，配置缺失会导致认证失败或连接中断。

1. 获取客户端出口 IP

在客户端机器执行 curl ifconfig.me，记录返回的公网 IP。若使用公司网络，IP 可能变动，需确认是否需配置 CIDR 段。

2. 配置云控制台白名单

登录云控制台 Redis 实例详情页，找到白名单设置，添加上一步获取的 IP。避免填写 0.0.0.0/0，除非测试环境。

3. 检查网络隔离 (VPC/安全组)

确认客户端 ECS 与 Redis 实例在同一 VPC 内。若跨 VPC，需创建对等连接。检查安全组是否放行 6379 端口。

4. 核对认证与加密配置

确认连接密码正确，部分实例需填写账号（如 default）。若实例开启 SSL，客户端需勾选 Use SSL。

白名单修改后通常秒级生效，个别平台可能有最多 2 分钟缓存。

使用 redis-cli ping 测试，若返回 PONG 则连接正常。若报错 ERR client ip is not in whitelist，说明 IP 仍未匹配。

检查应用日志，确认无 JedisDataException 或 Connection refused 异常。

局域网 IP 误填：白名单需填公网出口 IP，填 192.168.x.x 无效。

安全组混淆：Redis 实例本身依赖白名单，部分云厂商不支持直接配置实例安全组，需配置关联 ECS 的安全组。

密码特殊字符：密码含特殊字符可能导致转义问题，建议临时改为纯字母数字测试。

数据库编号错误：云端 Redis 可能限制 database 数量为 1，客户端需指定 db 0。

默认不能连接，不同 VPC 网络不通。需创建 VPC 对等连接打通网络，或将 ECS 迁移至同一 VPC。

实例强制开启密码认证但客户端未填密码。需在云控制台获取访问密码并填入客户端配置。

可能存在平台缓存，最多等待 2 分钟。或客户端 IP 发生变动，需重新确认出口 IP。

极度不安全，仅建议临时测试。生产环境应严格限制为具体业务 IP 段。