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

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

怎么配 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()，这个流程漏掉任一环，都等于白配。

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