RedisCache 配置不生效的主因是 Django 未连上 Redis 却静默失败,CACHES 中 LOCATION 必须为 redis://127.0.0.1:6379/1 格式;@cache_page 缓存失效常因响应头被覆盖、CommonMiddleware 添加 Vary、或开发环境误用缓存。

RedisCache 配置不生效,CACHES 设置对不上 Redis 实际地址
常见现象是调用 cache.set() 没报错,但查不到数据,或 @cache_page 完全不缓存——根本原因是 Django 没连上 Redis,却没抛异常。Django 默认用 django.core.cache.backends.dummy.DummyCache 时也静默失败。
-
CACHES中的LOCATION必须写成redis://127.0.0.1:6379/1这种完整 URL 格式(注意协议头),不能只写127.0.0.1:6379;否则会 fallback 到本地内存缓存 - 确保已安装
redis和django-redis(Django 自带的RedisCache后端依赖它) - 检查 Redis 服务是否运行:
redis-cli ping返回PONG才算通 - 如果用 Docker,
LOCATION里别写localhost,得换成容器名(如redis)或宿主机 IP(host.docker.internalon Mac/Win)
@cache_page 缓存失效快、命中率低,Cache-Control 头被覆盖
@cache_page 表面看是“加个装饰器就缓存”,实际受视图响应头和中间件双重影响。最常踩的坑是:明明设了 @cache_page(60 * 15),浏览器一刷新就重请求,Redis 里也查不到 key。
- 视图函数里手动写了
response['Cache-Control'] = 'no-cache',会直接覆盖@cache_page注入的max-age -
CommonMiddleware如果启用(默认开启),会对所有响应加Vary: Cookie, User-Agent,导致同一 URL 因不同用户/设备生成不同缓存 key,极大降低复用率 - 登录态页面慎用
@cache_page;未登录用户可缓存,但一旦视图里调用了request.user,Django 就自动加Vary: Cookie,让缓存失效 - 临时验证缓存是否生效:用
curl -I http://localhost:8000/xxx/看响应头是否有X-Cache: HIT(需配django-redis的日志)或直接查 Redis:redis-cli keys "*view*"
缓存键冲突:多个视图共用同一个 key_prefix 或没区分参数
@cache_page 默认按完整请求路径(含 query string)生成 key,但如果你手动调用 cache.set('my_key', ...),又没加命名空间,很容易和系统生成的 key 碰撞,导致缓存污染或误删。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能,主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该
- 自定义缓存操作务必加前缀:
cache.set(f'user_{user_id}_profile', data, 300),别裸用'profile' - 用
@cache_page时,如果 URL 是/api/items/?page=1和/api/items/?page=2,Django 会自动区分;但若你用 POST 提交分页参数,它就不缓存(因为 POST 默认不缓存) - 想让带 query string 的 GET 请求强制缓存,得在视图里显式设置:
response['Cache-Control'] = 'public, max-age=300',并确保没其他中间件干扰 - 调试键名:Django 生成的 view cache key 类似
:1:views.decorators.cache.cache_page./api/items/.GET.b64a...,可通过from django.core.cache import cache; print(cache.make_key('xxx'))验证生成逻辑
开发环境误用 Redis 缓存,改代码不生效
本地改了视图逻辑,浏览器刷新还是旧结果,第一反应是“缓存没清”,其实更可能是开发时忘了关缓存,或者清缓存方式不对。
- Django 开发服务器(
runserver)默认不启用CacheMiddleware,但@cache_page仍有效——它绕过中间件,直连 cache backend - 清缓存别只依赖
cache.clear():它清的是整个 db,可能误伤其他模块;更安全的是按前缀删:cache.delete_pattern('views.decorators.cache.*')(需django-redis支持) - 开发阶段建议把
CACHES切成LocMemCache,或加个开关:'BACKEND': 'django.core.cache.backends.redis.RedisCache' if not DEBUG else 'django.core.cache.backends.dummy.DummyCache' - 注意
DEBUG=True时,某些第三方包(如django-debug-toolbar)会主动禁用部分缓存行为,造成“线上正常、本地不缓存”的假象
缓存不是开关,是链路——从 Redis 连接、中间件顺序、响应头控制,到 key 命名和开发环境隔离,漏掉任意一环都可能让缓存形同虚设。最麻烦的往往不是配置,而是你以为它在工作,其实早就静默跳过了。










