Django Redis缓存配置教程

本文深入解析了 Django 中 Redis 缓存配置的实战要点与常见陷阱：从版本兼容性（Django 4.2+ 必须搭配 redis-py ≥ 4.0）、连接方式（URL 格式与 CLIENT_CLASS 显式声明）、缓存策略选择（cache_page 仅限 GET/HEAD，非幂等请求需手动 cache.set/get），到模板缓存键的稳定性设计（优先使用 user.pk 等确定性标识符）、会话安全加固（务必采用 cached_db 引擎防丢失），再到全页缓存失效这一易被忽视的关键难点——Django 不自动响应模型变更，必须借助信号或主动清理。每一步都直击生产环境中的真实痛点，帮你避开静默降级、用户数据泄露、会话崩溃等高危雷区。

Redis 连接配置必须匹配 Django 版本和 redis-py 版本

Django 4.2+ 默认要求 redis-py ≥ 4.0，而旧版 redis-py（如 3.x）用 redis.Redis(host=...) 初始化，新版默认启用 ConnectionPool 并强制校验 URL scheme。不匹配会导致 ValueError: Invalid URL scheme 或静默降级为本地内存缓存。

• 用 redis:// 开头的 URL 配置时，确保 redis-py ≥ 4.0：REDIS_URL = "redis://127.0.0.1:6379/1"
• 若仍用字典方式，Django 4.2+ 要显式指定 OPTIONS 中的 "CLIENT_CLASS"："CLIENT_CLASS": "django_redis.client.DefaultClient"
• 开发环境别直接复用生产 Redis DB 编号，DB=0 容易被其他服务误清，建议全站缓存固定用 DB=1

cache_page 装饰器对 POST/PUT 请求完全无效

cache_page 只拦截 GET 和 HEAD 请求，这是 Django 的硬性限制——它依赖请求方法判断可缓存性，POST 带副作用，框架直接跳过缓存逻辑。试图用它缓存表单提交后的结果页，实际每次都是穿透到视图执行。

• 需要缓存非 GET 场景，改用 cache.set() + cache.get() 手动控制，例如在视图末尾存渲染后 HTML：cache.set(f"page_{user_id}", response.content, 300)
• cache_page 的 timeout 参数单位是秒，不是毫秒；设成 0 表示永不过期，但 Redis 内存压力下仍可能被 LRU 清掉
• 如果视图用了 @login_required，cache_page 会把登录态混在一起缓存，导致用户看到别人的数据 —— 必须加 key_prefix 或改用 cache_control(private=True)

TemplateFragmentCacheNode 不会自动更新缓存键中的变量变化

模板里写 {% cache 300 sidebar user.id %}，看起来像按用户 ID 分片，但 Django 实际生成的缓存键是 ":1:template.cache.sidebar.123"（其中 123 是 user.id 当前值）。问题在于：如果 user.id 在后续请求中变了，但模板没重编译，Django 可能复用旧的缓存键逻辑，尤其在调试模式关闭、模板缓存启用时。

• 始终用稳定标识符做 key 组成部分，比如 user.pk 而非 user.id（避免 ORM 属性访问歧义）
• 避免在缓存键里拼接动态字符串，如 "sidebar_{{ user.username }}" —— 模板变量未解析就进 key，导致键名含花括号，Redis 存不了
• 调试时用 cache.keys("template.cache.*") 查看真实键名，确认是否含预期变量值

SESSION_ENGINE 切到 django.contrib.sessions.backends.cache 后，登录态变脆弱

单纯把 SESSION_ENGINE 改成 cache，Session 数据就只存在 Redis 里，没有数据库兜底。一旦 Redis 重启、网络抖动或连接超时，所有用户会话瞬间丢失，表现就是反复跳转到登录页。

• 生产必须用 cached_db 引擎：SESSION_ENGINE = "django.contrib.sessions.backends.cached_db"，它先查缓存，缓存 miss 再查 DB，并在 save 时双写
• 即使选了 cached_db，也要检查 SESSION_CACHE_ALIAS 是否指向正确的 Redis 配置别名（默认 "default"），否则 session 还是走本地内存
• Redis 内存不足时，cached_db 的 fallback 查询会变慢，建议监控 redis_used_memory_ratio 指标，提前扩容

全页缓存最麻烦的不是配置，而是缓存失效时机——Django 不会自动感知模型变更去删页面缓存，得靠信号或手动 cache.delete_pattern()，这点容易漏掉。

终于介绍完啦！小伙伴们，这篇关于《Django Redis缓存配置教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！