django-redis 4.12.1版本Redis读取超时重试设置咨询

针对你遇到的cache.get()间歇性Timeout Exception问题，仅配置retry_on_timeout: True无效的原因是该参数需要配合redis-py的重试策略一起使用，django-redis本身没有单独的重试开关，底层依赖redis-py的重试机制。以下是两种可行的解决方案：

方案一：通过Redis客户端配置原生重试策略 #

django-redis的REDIS_CLIENT_KWARGS可以直接传递redis-py客户端的参数，你需要在配置中指定重试次数、退避策略，结合retry_on_timeout实现自动重试。

修改你的缓存配置：

# 在settings.py顶部导入必要的类
from redis.retry import Retry
from redis.backoff import ExponentialBackoff

CACHES = {
    'default': {
        'BACKEND': 'django_redis.cache.RedisCache',
        'LOCATION': 'redis_server_url',
        'OPTIONS': {
            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
            'REDIS_CLIENT_KWARGS': {
                'ssl': True,
                'retry_on_timeout': True,
                # 配置重试：最多重试3次，使用指数退避（每次重试间隔1s、2s、4s，上限2s）
                'retry': Retry(ExponentialBackoff(cap=2, base=1), 3)
            },
            'CONNECTION_POOL_KWARGS': {'ssl_cert_reqs': False},
            'SOCKET_TIMEOUT':4,
            'SOCKET_CONNECT_TIMEOUT':4
        }
    }
}

• Retry参数说明：第一个参数是退避策略（ExponentialBackoff为指数退避，cap是最大延迟秒数，base是初始延迟），第二个参数是最大重试次数。
• 此方案依赖redis-py 3.0+，django-redis 4.12.1默认满足该依赖要求。

方案二：手动封装重试逻辑 #

如果原生配置不生效（比如版本兼容问题），可以手动封装缓存读取函数，捕获超时异常并重试：

from django.core.cache import cache
from redis.exceptions import TimeoutError

def cache_get_with_retry(key, max_retries=3, default=None):
    """带重试的缓存读取函数"""
    for _ in range(max_retries):
        try:
            return cache.get(key, default=default)
        except TimeoutError:
            continue
    # 所有重试失败后返回默认值
    return default

使用时替换原有的cache.get("mykey")为cache_get_with_retry("mykey", max_retries=3)即可。

注意事项 #

• 重试次数不宜过多，避免加重Redis服务负担；
• 指数退避策略可以避免短时间内频繁重试导致的服务雪崩；
• 若超时问题频繁出现，建议排查Redis服务的性能、网络延迟等底层问题，重试仅作为临时容错方案。

内容的提问来源于stack exchange，提问作者Sai Prasad Goud