MacOS下Django中Celery无法连接Docker内Redis的问题排查

核心问题 #

你遇到的错误根源是Mac本地系统无法解析Docker容器的redis主机名：

• 容器名redis仅在Docker内部的自定义网络中可被识别，Mac本地DNS无法解析这个名称。
• 你之前尝试localhost无效，大概率是Redis容器的端口映射未配置正确，或容器内部Redis绑定的地址不是0.0.0.0。

分步解决 #

1. 检查并配置Redis容器端口映射 #

先确认Redis容器是否将6379端口映射到Mac主机：

docker ps

查看输出中Redis容器的PORTS列，需显示0.0.0.0:6379->6379/tcp或:::6379->6379/tcp。如果没有该映射，重新启动Redis容器并添加端口映射：

# 停止并删除现有Redis容器（若存在）
docker stop <redis-container-id>
docker rm <redis-container-id>
# 启动带端口映射的Redis容器，强制绑定0.0.0.0确保外部可访问
docker run -d -p 6379:6379 --name redis redis --bind 0.0.0.0

2. 修改Celery配置文件 #

将settings.py中的Redis地址替换为Mac本地可访问的地址：

# Celery settings
CELERY_BROKER_URL = 'redis://localhost:6379/0'
CELERY_RESULT_BACKEND = 'redis://localhost:6379/0'

若localhost仍无效，尝试使用Mac本地IP（如192.168.x.x）或127.0.0.1：

CELERY_BROKER_URL = 'redis://127.0.0.1:6379/0'
CELERY_RESULT_BACKEND = 'redis://127.0.0.1:6379/0'

3. 验证Redis连接有效性 #

先测试Mac主机能否正常连接Redis：

redis-cli ping

若返回PONG说明连接正常；若报错，排查以下点：

• 检查Redis容器状态：docker logs redis，确认容器无启动报错
• 临时关闭Mac防火墙（系统设置→网络→防火墙）重试，或添加允许6379端口的规则

4. 重启Celery Worker #

配置修改完成后，重启Celery Worker：

python -m celery -A cartpe worker

额外场景（Docker Compose环境） #

如果你的Django也计划运行在Docker容器中，且通过Docker Compose统一管理，可保留redis://redis:6379/0的配置——默认情况下Compose会为所有容器创建统一网络，此时容器名redis可被正常解析。但当前你是在Mac本地运行Django，该场景不适用。

内容的提问来源于stack exchange，提问作者Srivatsa