0

0

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

霞舞

霞舞

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

|

643人浏览过

|

来源于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 访问对应数据库

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

✅ 正确操作方式:

# 进入 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 是必选参数。

PathFinder
PathFinder

AI驱动的销售漏斗分析工具

下载

✅ 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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

37

2026.02.04

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

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

344

2023.10.09

更新pip版本
更新pip版本

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

421

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、保存并关闭文件即可。

778

2024.12.23

python升级pip
python升级pip

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

356

2025.07.23

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

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

191

2023.09.27

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

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

10

2026.02.03

default gateway怎么配置
default gateway怎么配置

配置default gateway的步骤:1、了解网络环境;2、获取路由器IP地址;3、登录路由器管理界面;4、找到并配置WAN口设置;5、配置默认网关;6、保存设置并退出;7、检查网络连接是否正常。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

225

2023.12.07

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

127

2026.02.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
进程与SOCKET
进程与SOCKET

共6课时 | 0.4万人学习

Redis+MySQL数据库面试教程
Redis+MySQL数据库面试教程

共72课时 | 6.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号