Celery在Linux上仅pip install celery不够，必须同时安装Redis依赖并配置Broker和Backend，推荐执行pip install celery[redis]，再安装Redis服务并启动，否则worker无法运行。
Celery 在 Linux 上能直接装，但光 pip install celery 不够——缺消息代理（Broker）和结果后端（Backend），不配好就起不来 worker。
安装 Celery 和 Redis 依赖必须一起做
只运行 pip install celery 会卡在启动时提示 “No module named ‘kombu’” 或 “Unknown broker URL”，因为 Celery 默认不带任何消息传输层。Redis 是最轻量、最常用的选择，推荐一步到位：
-
pip install celery[redis]—— 方括号语法会自动拉取kombu、redis、vine等必要依赖 - 如果系统没装 Redis 服务，得先部署：Ubuntu/Debian 用
sudo apt install redis-server，RHEL/CentOS 用sudo yum install redis，然后确保redis-server正在运行（systemctl status redis） - 离线环境要提前下载完整依赖包：用
pip download celery[redis] --no-deps --platform manylinux2014_x86_64 --python-version 3.9 --only-binary=:all:，再补下载importlib-metadata、typing-extensions等间接依赖（Celery 5.x 强依赖它们）
celery -A 启动失败常见原因和修复点
执行 celery -A myproject.celery_app worker --loglevel=info 报错，大概率是路径或配置问题：
-
myproject.celery_app必须是一个可 import 的 Python 模块路径，且该模块里有名为celery_app（或你指定的变量名）的Celery实例，不能是文件名如celery.py（会和 Celery 自身模块冲突） - Broker URL 格式必须严格：
redis://127.0.0.1:6379/0可行，redis://localhost:6379/0在某些 DNS 配置下会超时；带密码时写成redis://:mypass@127.0.0.1:6379/0，冒号前空用户名不能省 - Linux 下不要加
-P eventlet——那是 Windows 专用的，加了反而报eventlet not installed或静默失败 - worker 启动后没日志？检查是否被 SELinux 或防火墙拦截了到 Redis 的连接（
redis-cli -h 127.0.0.1 ping先通不通）
异步任务提交后拿不到 result.get() 返回值
调用 task.delay() 成功，但 result.get(timeout=10) 卡住或抛 TimeoutError，问题基本出在 Backend 配置上：
- 必须显式设置
backend=参数，例如Celery('myapp', broker='redis://...', backend='redis://...')；只设 broker 不设 backend，result.ready()永远返回False - Broker 和 Backend 的 Redis DB 应分开，比如 broker 用 db 0，backend 用 db 1，否则任务元数据和结果可能互相覆盖
- 如果用的是 Redis Cluster，Celery 官方不支持——得换
redis-py-cluster并自己 patch，生产环境建议退回到单节点 Redis 或改用 RabbitMQ -
result.get()是同步阻塞调用，别在 Web 请求里直接用；应该用result.id存数据库，前端轮询/api/task-status?id=xxx接口查状态
真正麻烦的不是装不上，而是 Broker 连通性、Backend 可写性、模块导入路径这三处看似简单却极难一眼定位的问题。每次改完配置，务必用 redis-cli 手动连一下 URL 中的地址和 DB，再确认 Python 能 import 到那个 Celery 实例对象——这两步跳过，90% 的“启动失败”都白查日志。
