Redis连接失败主因是环境配置错误，如本地未启动Redis、Docker网络隔离导致访问失败；存取需注意序列化、空值判断及原子性设过期；应复用单例client并合理配置连接池。
redis-py 连接 Redis 失败的常见原因
连不上不是代码写错了，大概率是环境或配置没对上。最常踩的坑是默认 localhost 和 6379 端口在本地根本没跑 Redis 服务，或者 Docker 容器网络隔离导致 Python 进程访问不到 redis 容器名。
- 检查 Redis 是否真在运行：
redis-cli ping返回PONG才算通；Docker 用户别用localhost，改用宿主机 IP 或host.docker.internal（Mac/Win）或自定义网络里的容器名 -
ConnectionRefusedError基本等于 Redis 没启动，或防火墙拦了端口 - 用
redis.Redis(host="127.0.0.1", port=6379, db=0, decode_responses=True)显式传参，别依赖默认值——尤其decode_responses=True很关键，否则get()返回bytes，容易在后续 JSON 解析或字符串拼接时报TypeError
set() 和 get() 存取缓存时要注意什么
看起来就两行的事，但类型、序列化、空值处理全在这儿埋雷。Redis 只存字符串，set() 传进去的 dict/list/int 都会被自动转成字符串，取出来还是字符串，不是原对象。
- 存复杂数据必须自己序列化：
r.set("user:123", json.dumps(user_dict))，取的时候再json.loads(r.get("user:123")) -
get()找不到 key 返回None，不是空字符串，别直接if r.get("key"):判断——万一存的就是"0"或""就漏判了，得用is not None - 避免覆盖已有缓存：用
r.set("key", "val", nx=True)（仅当 key 不存在时设），配合ex=300控制过期时间，防止并发写入时旧数据残留
设置过期时间为什么有时不生效
过期时间不是写进命令就完事了，它受 Redis 版本、命令组合方式、甚至 key 是否已存在影响。
-
set("key", "val", ex=60)是原子操作，推荐；但分开写r.set("key", "val")+r.expire("key", 60)不是原子的，中间若出错，key 就永久存在了 - Redis 2.6+ 支持
ex（秒）、px（毫秒），老版本只认expire()；注意单位别混，ex=1是 1 秒，不是 1 分钟 - 如果 key 已存在且没设过期，
set(..., ex=60)会重置过期时间；但如果 key 原本就有过期时间，新set仍会覆盖它——这点容易被忽略，导致预期外的缓存延长
Python 连 Redis 的连接池要不要手动管
不用手建连接池，redis-py 默认就用 ConnectionPool，但得知道它怎么工作的，不然高并发下连接数爆炸或复用失效。
立即学习“Python免费学习笔记（深入）”；
- 单例复用 client 实例：全局只初始化一次
r = redis.Redis(...)，别每次请求都 new 一个，否则每个 client 都建独立连接池，内存和 socket 耗尽很快 - 连接池参数按需调：
max_connections=20控制上限，socket_connect_timeout=2避免卡死，retry_on_timeout=True对网络抖动更友好 - 别在多线程里共享未配置线程安全的 client——
redis-py本身是线程安全的，但前提是连接池没被手动关闭或销毁；Flask/FastAPI 中建议用依赖注入或全局变量管理 client
过期策略、连接复用、类型转换这三块最容易在上线后突然出问题，尤其是缓存击穿或连接堆积，往往不是代码逻辑错，而是初始化那几行没抠准。
