讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 Django + Docker 环境中正确访问 Redis 缓存数据

陌浩大大_9222

陌浩大大_9222

发布时间:2026-02-09 16:53:02

|

683人浏览过

|

来源于php中文网

原创

如何在 Django + Docker 环境中正确访问 Redis 缓存数据

django 应用通过 docker 连接 redis 后,`redis-cli` 默认无法查到缓存数据,根本原因通常是缓存后端未正确配置为 redis,或 `redis-cli` 访问了错误的数据库编号(默认 db0,而 django 缓存默认写入 db1)。

在 Django + Docker + Redis 的典型部署中,Redis 服务本身运行正常(如 Celery 的 Kombu 队列键已可见),但手动使用 redis-cli 查不到应用层缓存(如 get milan 返回 (nil),keys * 仅显示 Celery 相关键),这通常不是连接问题,而是缓存配置与 CLI 访问不匹配所致。以下是关键排查与修复步骤:

✅ 1. 确保 Django 使用 Redis 作为缓存后端

Django 默认的 CACHES 配置使用的是内存缓存(LocMemCache),它完全独立于 Redis,因此即使 Redis 正在运行,也不会存入任何数据。你必须显式配置 Redis 缓存后端。

在 settings.py 中添加或修改如下配置(推荐使用 django-redis,需先安装:pip install django-redis):

# settings.py
CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://redis:6379/1",  # 注意:数据库编号为 1(非默认 0)
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    }
}
⚠️ 注意:LOCATION 中的 /1 表示使用 Redis 的 database 1。这是 django-redis 的默认行为(避免与 Celery 的 broker 占用的 db0 冲突)。若你改用 /0,则需同步调整 Celery 配置,否则可能引发竞争或覆盖。

✅ 2. 使用 redis-cli -n <db> 访问对应数据库

redis-cli 默认连接 db0,而 Django 缓存写入的是 db1(如上配置),因此直接执行 keys * 自然查不到数据。

✅ 正确操作方式:

Docker Encyclopedia
Docker Encyclopedia

Docker 文档优先工作流:针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载
# 进入 Redis 容器并指定数据库 1
docker exec -it redis redis-cli -n 1

# 在 redis-cli 中查看所有缓存键
127.0.0.1:6379> keys *
1) ":1:my_cached_key"      # django-redis 默认加前缀 ":1:"
2) ":1:milan"

# 获取值(注意前缀)
127.0.0.1:6379> get ":1:milan"
"\"Hello from cache!\""

? 提示:django-redis 默认为每个 key 添加数据库编号前缀(如 :1:keyname),可通过 KEY_PREFIX 配置自定义,但 -n 1 是必选参数。

✅ 3. 验证缓存是否真正生效

在 Django shell 中测试缓存读写(确保 DEBUG=True 且服务已重启):

docker exec -it django python manage.py shell
>>> from django.core.cache import cache
>>> cache.set('milan', 'Hello from cache!', timeout=300)
True
>>> cache.get('milan')
'Hello from cache!'

此时再进入 redis-cli -n 1,即可看到对应 key。

? 补充说明:Celery 与缓存的数据库分离建议

你的 docker-compose.yml 中 Celery 的 CELERY_BROKER 和 CELERY_BACKEND 均指向 redis://redis:6379/0 —— 这是最佳实践:Broker(任务队列)和 Cache(应用缓存)应使用不同 Redis database,避免相互干扰。因此:

  • ✅ Celery → db0(队列、事件、结果)
  • ✅ Django Cache → db1(业务缓存)
  • ❌ 不要将两者混用同一 db,否则 keys * 会混乱,且存在数据误删风险。

✅ 总结检查清单

项目 正确配置 验证方式
CACHES['default']['BACKEND'] "django_redis.cache.RedisCache" 检查 settings.py
CACHES['default']['LOCATION'] redis://redis:6379/1(与 Celery 的 /0 分离) print(settings.CACHES)
redis-cli 访问 docker exec -it redis redis-cli -n 1 keys * 应返回带 :1: 前缀的 key
Django 缓存调用 cache.set() / cache.get() 成功 Shell 中执行并观察返回值

完成以上配置后,Django 缓存将稳定落库至 Redis db1,redis-cli -n 1 可实时观测、调试与清理,彻底解决“数据不可见”问题。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

553

2026.02.04

Python Django REST Framework接口安全与认证体系实践
Python Django REST Framework接口安全与认证体系实践

本专题围绕 Django REST Framework 展开,深入讲解 API 认证、JWT 鉴权、权限控制、接口安全防护以及防攻击策略设计。通过完整后端案例,帮助开发者构建安全可靠的 Web API 服务体系。

240

2026.06.29

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

3150

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

7183

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

8822

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

4527

2025.07.23

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

3020

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

249

2026.02.03

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn