登录
首页 >  文章 >  python教程

Django配置Redis缓存加速数据库访问

时间:2026-04-10 11:15:44 260浏览 收藏

本文深入解析了在 Django 项目中正确集成 Redis 缓存以显著提升数据库访问性能的完整实践路径,不仅涵盖 django-redis 的安装与核心配置(如 CACHES 设置、URL 格式、密码支持、数据库编号)、中间件顺序陷阱、cache_page 装饰器的生效条件与常见失效原因,还系统梳理了 Session 存储到 Redis 的关键细节(包括引擎选择、TTL 对齐、防丢失策略),并直击开发者高频踩坑点——如缓存键前缀混淆、序列化乱码、GET 参数影响、复杂对象反序列化风险等,强调缓存效能不取决于简单启用,而在于精准的键设计、严谨的读写流程和健壮的降级逻辑,为构建高性能、可维护的 Django 应用提供了一站式避坑指南。

Python Django怎么用Redis_配置Redis缓存系统与加速数据库访问及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 参数不同会被当成不同缓存键,但默认不包含 CookieAuthorization 头,所以登录态页面不能光靠 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': 1209600CACHES['default']['OPTIONS'] 里,不然重启 Redis 就全丢

cache.get() 返回 None 却查不到 Redis 里有对应 key

大概率是 key 被自动加了前缀,或者序列化方式不一致。Django Redis 默认用 pickle 序列化,但如果你用 redis-cli 直接查,看到的是二进制乱码,不是明文。

  • 检查 KEY_PREFIX 是否设置了,比如 'myapp:',那实际 key 就是 myapp:mykeyredis-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(),这个流程漏掉任一环,都等于白配。

以上就是《Django配置Redis缓存加速数据库访问》的详细内容,更多关于的资料请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>