必须用django-redis而非redis-py;CACHES"default"须设为django_redis.cache.RedisCache,否则缓存静默降级为LocMemCache导致cache.get()总返回None,且漏配OPTIONS中CLIENT_CLASS会引发AttributeError。

必须用 django-redis,不能只装 redis-py;CACHES["default"]["BACKEND"] 必须设为 django_redis.cache.RedisCache,否则缓存静默失效或报 AttributeError。
为什么 cache.get() 总是返回 None
这不是 Redis 没启动,而是 Django 根本没连上 Redis —— 它会自动降级到 LocMemCache,不报错、不警告、只返回 None。
-
CACHES["default"]["BACKEND"]写成django.core.cache.backends.redis.RedisCache(Django 5.0+ 原生支持)会导致序列化失败,cache.get()静默返回None -
LOCATION用localhost而非127.0.0.1:某些 Docker 或云环境 DNS 解析卡住,连接超时后也降级 - 漏掉
"OPTIONS": {"CLIENT_CLASS": "django_redis.client.DefaultClient"}:底层Redis实例缺setex等方法,cache.set()看似成功,实际没写入 - 验证方式:进
python manage.py shell,执行from django.core.cache import cache; cache.set('test', 'ok', 30); print(cache.get('test'))。输出None就得立刻查cache.client.connection_pool.get_connection()是否抛异常
模板 {% cache %} 标签参数怎么写才不崩
缓存键由所有参数字符串拼接生成,任意不可哈希或动态值都会让缓存失效或直接报错。
- 传
None、datetime、request整体 →TypeError: unhashable type;改用user.id、obj.pk、request.path等确定性字符串 - 不要写
{% cache 300 sidebar request %};应写{% cache 300 sidebar user.id request.path %} - 带查询参数的页面慎用:如
request.GET.get("utm_source")含随机追踪 ID,每次请求键都不同,缓存形同虚设 - 加可预测前缀:用
{% cache 300 "product_detail" product.id %},后续清理可用cache.delete_pattern("cache_product_detail_*")
cache_page 不生效的三个硬性条件
@cache_page 不是“加个装饰器就完事”,它对中间件顺序、视图类型、请求头处理极其敏感。
- 只对函数视图生效;类视图必须写成
@cache_page(900)(MyView.as_view()),不能装饰类本身 -
MIDDLEWARE中UpdateCacheMiddleware必须排第一,FetchFromCacheMiddleware必须排最后,中间不能插其他中间件(如CommonMiddleware必须夹在两者之间) - 默认不缓存含
Cookie或Authorization的请求;登录态页面若强行用@cache_page,用户可能看到别人的数据
Session 存 Redis 后频繁登出?生命周期没对齐
Redis key 默认永不过期,但 Django Session 有自己的一套过期逻辑,不显式同步就会丢状态。
-
SESSION_ENGINE仅设为django.contrib.sessions.backends.cache风险高:缓存失效即登出;推荐用django.contrib.sessions.backends.cached_db(缓存+DB 双写) - 必须配
SESSION_CACHE_ALIAS = "default",确保 Session 和缓存走同一个 Redis 连接池 - Redis 数据库编号要和
CACHES["default"]["LOCATION"]一致,比如都用/1;混用不同 DB 会导致 key 找不到 - 别依赖 Redis 自身的
timeout:Django Session 过期靠的是expire_date字段,不是 Redis TTL
最常被忽略的点:所有缓存键名都是 Django 内部生成且不暴露的,你无法靠猜去删;清理必须靠 delete_pattern 或统一命名前缀 + 显式 delete。没有主动失效策略的缓存,迟早变成脏数据黑洞。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











