不能直接在Flask路由中执行耗时任务，因其同步阻塞模型会独占worker进程导致请求排队、用户转圈或超时；必须将任务剥离HTTP生命周期，交由独立Celery worker异步处理。
为什么直接在Flask路由里跑耗时任务会卡住请求
Flask默认是单线程同步模型，time.sleep(10)、大文件处理、调用外部API等操作会阻塞整个worker进程，导致其他请求排队等待。用户看到的是“转圈”或超时错误，而不是任务在后台运行。
关键不是“怎么加Celery”，而是必须把耗时逻辑从HTTP请求生命周期中剥离出来——Celery worker是独立进程，和Flask web server完全解耦。
初始化Celery实例时不能直接用Flask的current_app
Celery启动早于Flask应用上下文，current_app此时不可用，常见错误是写成：
from flask import current_app celery = Celery(__name__, broker='redis://localhost:6379') celery.conf.update(current_app.config) # ❌ 运行时报 RuntimeError: Working outside of application context
正确做法是延迟绑定配置，用工厂函数或手动传参：
立即学习“Python免费学习笔记（深入）”；
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 在
celery.py中只创建实例，不依赖Flask对象：celery = Celery('tasks', broker='redis://localhost:6379') - 在
create_app()里调用celery.conf.update(...)，或用celery.config_from_object(app.config) - 任务函数内部如需访问数据库，应自己初始化
db连接，不要假设current_app存在
任务函数里不能直接用request或session
HTTP请求对象只存在于Flask主线程的上下文中，Celery worker进程根本没收到request。试图在@celery.task里读request.json会报RuntimeError: Working outside of request context。
必须显式传递所需数据：
- 把参数序列化后传入任务：
send_email.delay(user_id=123, template='welcome') - 避免传
request对象本身，更别传session或g这类上下文绑定变量 - 如果需要用户身份，传
user_id，任务内再查数据库获取完整信息
本地开发时worker进程起不来？检查Redis和broker URL
Celery默认不带消息代理，必须单独安装并运行Redis（或RabbitMQ）。常见失败现象：
-
ConnectionRefusedError: [Errno 111] Connection refused→ Redis没启动，执行redis-server -
InvalidURL: No connection adapters were found for 'redis//localhost:6379'→ URL少了个冒号，应为redis://localhost:6379 - worker日志停在
Ready但任务不执行 → 检查Flask项目路径是否在Python path里，确保celery -A myproject.celery worker --loglevel=info能import到celery实例
复杂点在于：Celery配置项多、上下文隔离严格、错误堆栈常掩盖真实原因。最容易被忽略的是——任务函数修改后，必须重启worker进程才能生效，热重载对Celery无效。
