Python Django缓存机制配置_利用Redis实现全页数据缓存-Python教程-PHP中文网

Redis连接需匹配Django与redis-py版本，Django 4.2+要求redis-py≥4.0；cache_page仅支持GET/HEAD请求；模板缓存键须用稳定标识符如user.pk；session务必用cached_db引擎防丢失。

python django缓存机制配置_利用redis实现全页数据缓存

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 可能复用旧的缓存键逻辑，尤其在调试模式关闭、模板缓存启用时。

Django Wrap

强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该

下载

始终用稳定标识符做 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()，这点容易漏掉。