Celery 是一个用于 分布式任务队列 的 Python 库，常用于处理异步任务（即任务不需要立即执行，后台慢慢做），尤其适合执行定时任务或耗时操作。

---

🌟 简单理解

Celery 就是让你把“任务”扔到后台执行，而不是阻塞当前程序。

---

🛠️ 核心功能

功能	说明
异步任务执行	比如发邮件、处理图片、生成报告等不需要立即完成的操作。
分布式任务调度	可以运行在多台服务器上，实现任务负载均衡。
定时任务（周期任务）	类似 crontab，可设置任务定时执行（如每天 8 点发日报）。
任务重试机制	失败任务可以自动重试，适用于网络波动等场景。
与Django/Flask集成	非常适合与这些 Web 框架配合使用，将长耗时任务下放到 Celery。

---

🚀 工作机制

Celery 一般由以下几部分组成：

1. Producer（生产者）：你写的代码，会将任务“发”出去。
2. Broker（中间人）：任务先存放在消息队列（如 Redis、RabbitMQ）中。
3. Worker（工人）：后台运行的进程，专门“接收”和“执行”这些任务。
4. Result Backend（结果后端）：可选，记录任务结果，如执行成功或失败。

---

📦 示例代码（使用 Redis 作为 broker）

# tasks.py
from celery import Celery

app = Celery('mytasks', broker='redis://localhost:6379/0')

@app.task
def add(x, y):
    return x + y

运行方式：

celery -A tasks worker --loglevel=info

调用方式（异步执行）：

add.delay(3, 5)  # 返回一个异步结果对象

---

🔗 常见搭配

• 消息中间件：Redis、RabbitMQ（推荐 Redis 简单易用）
• Web框架集成：Django、Flask
• 配合 Flower、Prometheus、Grafana 等工具可实现任务监控

---

如果你正在开发一个 需要做“异步处理”或“后台任务”的系统，Celery 是 Python 中的主流选择之一。但是该库看似简单，却隐藏着无数坑，本文就带大家了解一下我在使用过程中遇到的那些坑。

📦 我的环境

• windows 10
• python 3.12
• celery 5.5.2

📦第一个问题

执行命令：

celery -A main_async:celery_app worker --loglevel=info

报错：

[2025-05-29 19:40:22,107: INFO/MainProcess] Task main_async.background_content_similarity[4c84e1c8-6a13-4241-8e62-04e17b3884cb] received
[2025-05-29 19:40:22,142: ERROR/MainProcess] Task handler raised error: ValueError('not enough values to unpack (expected 3, got 0)')
billiard.einfo.RemoteTraceback:
"""
Traceback (most recent call last):
  File "D:\ProgramData\Anaconda3\envs\gj_ai_new\Lib\site-packages\billiard\pool.py", line 362, in workloop
    result = (True, prepare_result(fun(*args, **kwargs)))
                                   ^^^^^^^^^^^^^^^^^^^^
  File "D:\ProgramData\Anaconda3\envs\gj_ai_new\Lib\site-packages\celery\app\trace.py", line 640, in fast_trace_task
    tasks, accept, hostname = _loc
    ^^^^^^^^^^^^^^^^^^^^^^^
ValueError: not enough values to unpack (expected 3, got 0)
"""

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "D:\ProgramData\Anaconda3\envs\gj_ai_new\Lib\site-packages\billiard\pool.py", line 362, in workloop
    result = (True, prepare_result(fun(*args, **kwargs)))
                                   ^^^^^^^^^^^^^^^^^^^^
  File "D:\ProgramData\Anaconda3\envs\gj_ai_new\Lib\site-packages\celery\app\trace.py", line 640, in fast_trace_task
    tasks, accept, hostname = _loc
    ^^^^^^^^^^^^^^^^^^^^^^^
ValueError: not enough values to unpack (expected 3, got 0)

该问题是由于celery的默认并发网络编程线程库引起的，换成eventlet可以解决问题，只需修改启动命令即可，如下：

celery -A main_async:celery_app worker --loglevel=info -P eventlet

📦第二个问题

第二个问题是日志问题，报错类似如下所示：

'LoggingProxy' object has no attribute 'encoding'"

原因分析

Celery 在启动 worker 时，默认会将标准输出和标准错误重定向到其日志系统中。这意味着 sys.stdout 和 sys.stderr 被替换为 LoggingProxy 对象。然而，某些库或代码可能期望这些对象具有标准文件对象的属性，如 encoding 或 fileno，从而导致 AttributeError。

此时只需要将worker_redirect_stdouts参数设置为False即可解决问题，代码如下：

# Celery 配置
celery_app.conf.update(
    task_serializer="json",
    accept_content=["json"],
    result_serializer="json",
    timezone="Asia/Shanghai",
    enable_utc=True,
    include=["main_async"],  # 显式指定任务模块
    task_track_started=True,  # 跟踪任务开始状态
    task_ignore_result=False,  # 保存任务结果
    task_store_errors_even_if_ignored=True,  # 存储错误
    worker_redirect_stdouts = False	# 禁止将stdout和stderr重定向到当前记录器。
)