需安装django-redis并配置caches,指定backend为django_redis.cache.rediscache、location为带数据库编号的redis url,同时正确设置中间件顺序、session引擎及缓存键前缀等细节。

怎么配 settings.py 让 Django 用上 Redis 缓存
不是装个 redis 包就完事,Django 默认不认 Redis,得靠第三方缓存后端。最常用的是 django-redis,它把 Redis 当成缓存后端来用,也支持 Session 存储。
先装依赖:
pip install django-redis
然后在 settings.py 里改两处:
-
CACHES必须定义,不能只写CACHE_BACKEND(老版本遗留,已失效) -
LOCATION要写完整 URL 或地址+端口,比如redis://127.0.0.1:6379/1,末尾的/1是数据库编号,别漏掉 - 如果 Redis 开了密码,必须写进 URL 里:
redis://:mypassword@127.0.0.1:6379/1,冒号前空着表示无用户名
典型配置长这样:
CACHES = {
'default': {
'BACKEND': 'django_redis.cache.RedisCache',
'LOCATION': 'redis://127.0.0.1:6379/1',
'OPTIONS': {
'CLIENT_CLASS': 'django_redis.client.DefaultClient',
}
}
}
为什么 cache_page 不生效或缓存没命中
常见错因不是 Redis 没连上,而是视图没走对路——cache_page 只对函数视图或基于类视图的 as_view() 生效,且要求中间件顺序正确。
-
UpdateCacheMiddleware必须在最前,FetchFromCacheMiddleware必须在最后,中间不能插其他中间件(比如CommonMiddleware得放它们之间) - 函数视图直接套装饰器:
@cache_page(60 * 15);类视图要写在as_view()调用时:path('api/', MyView.as_view(), {'cache_timeout': 900}),再配合自定义逻辑 - GET 参数不同会被当成不同缓存键,但默认不包含
Cookie或Authorization头,所以登录态页面不能光靠cache_page,得手动用cache.set()控制
Session 存 Redis 后,用户频繁登出或状态丢失
这不是 Redis 问题,是 Session 配置和生命周期没对齐。Django 默认 Session 过期时间是 1209600 秒(2 周),但 Redis 的 key 默认永不过期,必须显式设 TIMEOUT。
- 必须设置
SESSION_ENGINE = 'django.contrib.sessions.backends.cache'或更稳妥的'django.contrib.sessions.backends.cached_db'(缓存+DB 双写,防丢) - 单独用 cache 后端时,
SESSION_CACHE_ALIAS要指向你定义的缓存别名,比如'default',否则它会 fallback 到default但可能没配好 - Redis 里 Session key 的 TTL 必须和
SESSION_COOKIE_AGE对齐,建议显式加'TIMEOUT': 1209600到CACHES['default']['OPTIONS']里,不然重启 Redis 就全丢
cache.get() 返回 None 却查不到 Redis 里有对应 key
大概率是 key 被自动加了前缀,或者序列化方式不一致。Django Redis 默认用 pickle 序列化,但如果你用 redis-cli 直接查,看到的是二进制乱码,不是明文。
- 检查
KEY_PREFIX是否设置了,比如'myapp:',那实际 key 就是myapp:mykey,redis-cli keys '*'看不到原始名 - 别用
redis-cli get mykey直接查,要用get myapp:mykey,或者改用django-redis自带命令:from django.core.cache import cache cache._cache.get_client(True).keys('*') - 如果存的是复杂对象(如 model 实例),
pickle在不同 Python 版本或部署环境可能反序列化失败,简单值(str/int/dict/list)更稳
Redis 缓存不是“开了就快”,关键在缓存键的设计粒度、过期策略和降级逻辑。比如查数据库前先 cache.get(),没命中再查库并 cache.set(),这个流程漏掉任一环,都等于白配。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











