应使用 django-redis 而非 Django 5.0+ 原生 RedisCache,因其缺乏连接池、压缩、pattern 删除等关键能力;配置需含 CLIENT_CLASS、用 URL 格式 LOCATION、显式设 CONNECTION_POOL_KWARGS;模板缓存键为字符串拼接,参数须可哈希;@cache_page 需严格中间件顺序和视图调用方式。

直接用 django-redis,别碰 Django 5.0+ 原生的 django.core.cache.backends.redis.RedisCache——它缺连接池、压缩、pattern 删除等关键能力,线上容易出 silent failure。
pip install django-redis 且只装这一个包
不装 redis-py 单独包,也不装 django-redis-chs 等镜像包。官方 django-redis 已内置完整依赖和修复补丁。
-
pip install django-redis是唯一必需命令;装错包会导致cache.set()不报错但cache.get()永远返回None - Django 5 默认静默降级到
LocMemCache,你根本收不到连接失败提示 - 验证是否生效:进
python manage.py shell,执行from django.core.cache import cache; cache.set('test', 1, 10); print(cache.get('test')),输出不是1就说明没连上
CACHES 配置必须带 OPTIONS.CLIENT_CLASS
漏掉 "CLIENT_CLASS": "django_redis.client.DefaultClient" 会触发 AttributeError: 'Redis' object has no attribute 'setex' 或静默失效。
-
LOCATION推荐用 URL 格式:"redis://:mypass@10.0.1.5:6379/2"(密码带冒号前空用户名),或"unix:///var/run/redis.sock?db=1" - 别写
localhost——Docker 容器内 DNS 解析可能卡住,改用127.0.0.1或宿主机 IP -
CONNECTION_POOL_KWARGS建议显式设:{"max_connections": 100, "retry_on_timeout": True},否则高并发下连接耗尽
模板 {% cache %} 的键生成规则很实在
缓存键不是哈希,是字符串拼接:cache_sidebar_1_/products/ 这种形式,任何参数变化都会命中新键。
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- 传
None、datetime、request整体 → 报TypeError: unhashable type;必须提前转成str(obj.id)或obj.pk - 别在参数里写
request.GET,它是个QueryDict,不可哈希;改用request.GET.get("q", "") - 加可预测前缀,比如
{% cache 300 "user_profile" user.id %},失效时能用cache.delete_pattern("cache_user_profile_*")精准清理
@cache_page 生效有硬性链路要求
它不看 Redis 是否在线,只看中间件顺序和视图调用方式——错一处就完全不走缓存。
- 中间件顺序必须严格:
UpdateCacheMiddleware在最前,FetchFromCacheMiddleware在最后,中间不能插其他中间件(CommonMiddleware必须夹在两者之间) - 类视图必须装饰
as_view()调用:path("api/", MyView.as_view(), {"cache_timeout": 900}),不能装饰类定义本身 - GET 参数默认参与键生成,但
csrf_token、_t=123456这类前端注入参数会让每次请求键都不同,建议用KEY_FUNCTION自定义键逻辑过滤掉它们
最常被忽略的是:缓存键名由 Django 自动生成且不暴露,你无法靠猜去删;所有主动失效动作(如用户更新资料后清 sidebar 缓存)必须和模板中使用的参数组合完全一致,否则删了也白删。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










