celery任务必须脱离flask应用上下文运行，因worker进程独立启动、无请求上下文；正确做法是将配置或对象显式传入任务，而非依赖current_app或g。
Celery 任务函数必须脱离 Flask 应用上下文运行
Flask 的 current_app 和 g 在 Celery worker 进程里根本不存在——worker 是独立于 Web 进程启动的，没请求、没上下文。直接在 @celery.task 里调用 current_app.config 或发邮件用的 mail.send()，会立刻报 RuntimeError: Working outside of application context。
正确做法是把必要配置或对象“传进去”，而不是“找回来”：
- 把邮件配置（如
MAIL_SERVER、MAIL_USERNAME）作为参数传给任务，或在任务内部从环境变量读取，别依赖current_app - 如果必须用 Flask-Mail 实例，不要在任务里 import 后直接调用
mail.send()；改用原生smtplib+email.mime构造并发送，更可控、无上下文依赖 - 工厂函数（如
create_app()）只用于 Web 进程，Celery worker 启动时应单独初始化自己的配置和客户端（比如SMTPHandler实例）
Flask 工厂模式下如何初始化 Celery 实例
不能在 create_app() 里直接创建 Celery() 并绑定 app——因为 create_app() 每次调用都返回新 app，而 Celery 实例需全局复用，且要支持 worker 独立加载。
标准解法是“分离初始化”：
- 定义一个独立模块（如
celery_worker.py或extensions.py），导出未绑定的Celery实例：from celery import Celery<br>capp = Celery('tasks')<br>capp.config_from_object('celeryconfig') - 在工厂函数中，用
capp.set_default()和capp.conf.update()注入部分运行时配置（如 broker URL），但不调用capp.init_app(app)（Celery 没这个方法） - worker 启动命令必须指向该实例：
celery -A celery_worker.capp worker --loglevel=info，不是-A app:create_app
发邮件任务里怎么安全处理 Flask-Mail 的依赖
很多人想复用 Flask-Mail 的 Message 类来构造邮件，这本身没问题，但它不依赖 Flask 上下文；真正出问题的是 mail.send() 方法——它内部用了 current_app 获取配置和连接。
绕过方式很直接：
- 用
Message构建邮件体（它纯数据，无副作用），然后用原生smtplib.SMTP发送：msg = Message(subject='Hi', recipients=['a@b.com'])<br>msg.body = 'hello'<br>smtp = smtplib.SMTP(current_app.config['MAIL_SERVER'])<br># ⚠️ 注意：这里 current_app 仍不可用！应提前传入或从环境读取
- 更推荐：任务函数参数显式接收 SMTP 配置项，例如：
@capp.task def send_email(to: str, subject: str, body: str, smtp_host: str, smtp_port: int, username: str, password: str) - 避免在任务里 import
from flask_mail import Mail—— 它会触发隐式上下文查找，哪怕你没调用send()
本地调试时 Celery worker 总连不上 Redis/Broker
常见现象是 ConnectionRefusedError: [Errno 111] Connection refused，尤其用工厂模式后，容易误以为是 Flask 配置没加载对，其实只是 broker 地址写死了或没启动。
检查点很具体：
- 确认
celeryconfig.py里的BROKER_URL或broker_url（Celery 5.0+ 用后者）值正确，比如redis://localhost:6379/0，不是localhost:6379（缺协议头） - Flask 开发服务器和 Celery worker 必须共用同一套环境变量；如果用
.env，确保celery命令执行时能读到（推荐用python -m celery …而非裸celery） - Windows 用户注意：默认
eventlet或gevent不兼容，加--pool=solo启动 worker，否则可能静默失败
最常被忽略的一点：Celery 任务代码修改后，worker 不自动 reload——每次改完必须手动重启 celery 进程，不然永远在跑旧逻辑。
