Redis连接失败报“Cannot assign requested address”大概率是客户端本机端口被TIME_WAIT占满,需先用ss -s和ss -tan state time-wait | grep ':6379'确认,再调tcp_tw_reuse等内核参数并改用连接池。

直接说结论:Redis 连接失败报 Cannot assign requested address 或反复超时,大概率是客户端本机端口被 TIME_WAIT 占满,不是 Redis 服务挂了,也不是密码错了——得先查本地连接状态,再调内核参数 + 改客户端行为。
怎么确认是 TIME_WAIT 导致的 Redis 连接失败
别急着改内核,先用命令验证问题根源:
- 运行
ss -s,看输出里time-wait行的数字。如果远高于established(比如 5 万 vs 200),基本锁定 - 查连 Redis 的 outbound 连接残留:
ss -tan state time-wait | grep ':6379'—— 注意这是你本机连出去、对方是:6379的连接,不是别人连你 - 检查可用端口是否见底:
cat /proc/sys/net/ipv4/ip_local_port_range,默认是32768 65535(共约 32768 个),若并发连接峰值长期超 2 万,就容易耗尽 - 看错误日志是否含
Cannot assign requested address或bind: Address already in use—— 这是内核无法分配源端口的明确信号
必须立即生效的内核参数调整(客户端侧)
Redis 客户端(如 Python 的 redis-py、Java 的 Jedis、Nginx upstream)在本机发起连接,属于“客户端角色”,以下参数只对它有效:
-
net.ipv4.tcp_tw_reuse = 1:允许把TIME_WAITsocket 复用于新 outbound 连接。前提是tcp_timestamps = 1(现代内核默认开,但建议显式设) -
net.ipv4.tcp_fin_timeout = 30:将FIN_WAIT_2和TIME_WAIT的等待时间从默认 60 秒缩到 30 秒,更激进但安全 -
net.ipv4.ip_local_port_range = 1024 65535:扩大临时端口范围,避免默认 32768 个不够用 -
net.ipv4.tcp_max_tw_buckets = 200000:防止内核因TIME_WAIT桶溢出而静默丢包(time wait bucket table overflow) - 绝对禁用
net.ipv4.tcp_tw_recycle = 0:该参数在任何 NAT 环境(包括公司路由器、云 SLB、K8s Service)下都会引发连接失败,Linux 4.12+ 已移除,切勿开启
应用层必须同步做的三件事
内核参数只是缓解,不改代码或配置,问题会反复出现:
- Redis 客户端必须用连接池,且
max_connections要设够:例如 QPS 峰值 1000,建议设为 1500–2000;设太小(如 1)会导致阻塞或强制新建连接,加剧TIME_WAIT - 所有连接必须显式设置超时:
timeout=5(或类似参数),否则底层 socket 无读写超时,连接卡住后不会归还池,间接逼客户端不断新建连接 - 禁用健康检查(
health_check_interval)或设为较长间隔(如 30s):频繁 ping 会制造大量短连接,每个都留下TIME_WAIT
特别注意 Redis 集群节点的双向角色
集群节点既是服务端(监听 6379),又是客户端(主动 connect 其他节点的 6379/16379)——这意味着它同时承受两端压力:
-
tcp_tw_reuse = 1对它至关重要:集群握手(CLUSTER MEET)、Gossip 通信全靠 outbound 连接,没它,节点间频繁失联 - 不能只看
ss -tuln | grep 6379,还得查ss -tan state time-wait | grep ':16379'—— 集群总线端口也会产生大量TIME_WAIT - 启动失败报
Address already in use,90% 是本地端口池耗尽,不是 6379 被占;杀进程没用,得等TIME_WAIT自然释放或靠tw_reuse复用
最易被忽略的一点:很多人只盯着 Redis 服务端配置(maxclients、timeout),却忘了客户端发起连接的行为才是 TIME_WAIT 的源头。调参能扛一时,连接池设计、超时控制、健康检查策略这些代码级决策,才真正决定你每天凌晨会不会被电话叫醒。











