TimeoutError 既可能发生在 Redis 连接阶段（如初始化时网络不通），也可能发生在命令执行阶段（如 get/set 响应超时）；需分别配置 socket_connect_timeout 和 socket_timeout 参数。
TimeoutError 是 Redis 连接阶段还是命令执行阶段抛出的？
关键要分清：Redis 的 TimeoutError 大多来自底层 socket 层，它既可能发生在 redis.Redis() 初始化连接时（比如服务未启动、网络不通），也可能在调用 get()、set() 等命令时因响应超时触发。Python redis 库默认不主动探测连接健康状态，所以“连接成功”不等于“后续命令一定成功”。
如何配置连接和命令级超时参数？
redis-py 提供两组独立超时控制，必须显式设置，否则依赖系统默认（可能长达数分钟）：
-
socket_connect_timeout：仅作用于建立 TCP 连接阶段，单位秒，建议设为2～5 -
socket_timeout：作用于所有命令读写操作，包括get、hgetall等，也建议设为2～5 - 两者可不同值；若只设
socket_timeout，连接阶段仍可能卡住很久
示例初始化：
r = redis.Redis(
host='127.0.0.1',
port=6379,
db=0,
socket_connect_timeout=3,
socket_timeout=3,
retry_on_timeout=False # 默认 False，设 True 会自动重试一次（慎用）
)
捕获 TimeoutError 时该重试还是降级？
直接 except redis.exceptions.TimeoutError: 捕获即可，但处理策略取决于场景：
- 读请求（如缓存获取）：优先返回默认值或查 DB，避免阻塞主流程
- 写请求（如计数器 incr）：若业务允许丢失，可静默忽略；否则需记录日志并告警
- 不要无条件重试 —— 连续超时往往说明 Redis 不可用，重试只会放大压力
- 注意：redis-py 的
retry_on_timeout=True仅对单条命令重试一次，且不适用于连接失败
为什么加了超时参数还是卡住十几秒？
常见原因有三个：
- 没设
socket_connect_timeout，DNS 解析失败或目标 IP 不可达时，系统默认 connect 超时可能达 20+ 秒 - 使用了连接池（
ConnectionPool）但没把超时参数传给 pool 实例，导致参数被忽略 - Redis 服务器本身卡死（如 OOM、AOF rewrite 占满 CPU），此时 socket 已连上但无响应，靠
socket_timeout控制
正确用连接池示例：
pool = redis.ConnectionPool(
host='127.0.0.1',
port=6379,
db=0,
socket_connect_timeout=3,
socket_timeout=3,
max_connections=20
)
r = redis.Redis(connection_pool=pool)
超时不是万能开关，它只管 socket 层；Redis 进程假死、网络中间设备拦截、客户端 DNS 缓存污染这些情况，得靠健康检查 + 监控配合发现。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
