Python Redis客户端连接不可用时超时设置失效问题求助

问题背景 #

Redis连接正常时，socket_timeout与socket_connect_timeout设置可正常生效；但Redis服务器不可用时，超时设置完全失效——示例中设置了0.007秒的超时阈值，实际却要等待5秒才抛出异常，不符合预期。

使用环境：

• Python 3.12
• Redis Python客户端 5.2.0
• Docker Compose中禁用Redis服务用于超时测试

解决方案 #

方案1：用IP地址替代主机名 #

直接使用Redis服务器的IP地址连接，跳过DNS解析环节（系统默认DNS超时通常为5秒，不受客户端参数控制）。修改后代码：

from redis import Redis

# 替换为实际Redis服务器的IP
r = Redis('192.168.1.100', 6379, 7, socket_timeout=.007, socket_connect_timeout=.007)
results = r.mget('key1', 'key2', 'key3')

方案2：手动控制DNS解析超时 #

若必须使用主机名，可手动解析主机名并设置DNS超时，再将解析后的IP传入客户端：

import socket
from redis import Redis

def resolve_redis_host(host, port, timeout=0.007):
    try:
        addrinfo = socket.getaddrinfo(host, port, socket.AF_INET, socket.SOCK_STREAM)
        redis_ip = addrinfo[0][4][0]
        # 验证连接超时
        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        sock.settimeout(timeout)
        sock.connect((redis_ip, port))
        sock.close()
        return redis_ip
    except (socket.timeout, socket.gaierror, ConnectionRefusedError):
        raise RuntimeError("Redis服务器不可达或DNS解析超时")

redis_ip = resolve_redis_host('redis', 6379, timeout=0.007)
r = Redis(redis_ip, 6379, 7, socket_timeout=.007, socket_connect_timeout=.007)
results = r.mget('key1', 'key2', 'key3')

方案3：调整客户端重试策略 #

Redis-py 5.x默认启用连接重试，多次重试的时间累加可能导致总等待时间超标。可关闭重试或限制重试次数：

from redis import Redis
from redis.retry import Retry
from redis.backoff import NoBackoff

# 禁用重试，仅尝试1次连接
r = Redis(
    'redis', 
    6379, 
    7, 
    socket_timeout=.007, 
    socket_connect_timeout=.007,
    retry=Retry(NoBackoff(), max_attempts=1)
)
results = r.mget('key1', 'key2', 'key3')

原因说明 #

1. DNS解析超时：使用主机名连接时，系统默认DNS解析超时为5秒，该过程不受Redis客户端的socket_connect_timeout参数管控，导致总等待时间被拉长。
2. 默认重试机制：Redis-py 5.x版本默认会重试连接，多次尝试的时间累加后，总时长会超过预期的单次超时阈值。

内容的提问来源于stack exchange，提问作者jonsbox