扫描二维码关注或者微信搜一搜：编程智域 前端至全栈交流与成长
发现1000+提升效率与开发的AI工具和实用程序：https://tools.cmdragon.cn/
在FastAPI框架中，后台任务(Background Tasks)指不需要立即返回给客户端的操作处理。当客户端请求需要执行耗时操作（如发送邮件、处理文件）时，同步处理会导致响应延迟，而异步处理通过将任务加入后台队列立即返回响应。
安装所需依赖：
pip install fastapi==0.68.0 uvicorn==0.15.0 pydantic==1.10.7
示例邮件发送实现：
from fastapi import BackgroundTasks, FastAPI
from pydantic import BaseModel
app = FastAPI()
class EmailRequest(BaseModel):
recipient: str
content: str
def send_confirmation_email(email: str, message: str):
# 模拟耗时操作
import time
time.sleep(2)
print(f"Email to {email}: {message}")
@app.post("/send-email/")
async def send_email(
request: EmailRequest,
background_tasks: BackgroundTasks
):
background_tasks.add_task(
send_confirmation_email,
email=request.recipient,
message=request.content
)
return {"status": "Email queued"}
代码解析：
当调用add_task()时，任务会被添加到Starlette的BackgroundTask队列。每个请求会创建独立的任务队列，保证请求之间的隔离性。
任务在响应返回后开始执行，采用先进先出(FIFO)原则。FastAPI默认使用线程池执行任务，可通过以下配置修改：
@app.post("/task", background=BackgroundTask(executor=custom_executor))
如用户注册成功后发送验证邮件，避免阻塞注册流程
上传大文件后立即返回接收确认，后台执行格式转换
接收数据后快速响应，后台执行数据标准化和存储
问题1：当后台任务执行抛出异常时，默认处理机制是什么？
A) 自动重试3次
B) 记录日志并继续
C) 终止整个应用
D) 忽略错误继续执行
正确答案：B
解析：FastAPI默认配置下会捕获任务异常并记录到日志系统，但不会中断应用运行。对于关键任务建议添加重试机制。
问题2：以下哪种情况适合使用后台任务？
A) 需要实时获取处理结果的图像识别
B) 用户注册后的欢迎邮件发送
C) 即时聊天消息传递
D) 在线支付的金额扣减
正确答案：B
解析：后台任务适用于不需要即时反馈的后续处理，邮件发送属于典型用例。
产生原因：
解决方法：
class EmailRequest(BaseModel):
recipient: str = Field(..., example="user@example.com")
当后台任务抛出未捕获异常时，虽然不会影响本次请求响应，但会在服务器日志中记录错误。
预防建议：
from tenacity import retry, stop_after_attempt
@retry(stop=stop_after_attempt(3))
def send_confirmation_email(email: str, message: str):
# 任务实现
余下文章内容请点击跳转至 个人博客页面 或者 扫码关注或者微信搜一搜：编程智域 前端至全栈交流与成长，阅读完整的文章：FastAPI后台任务：异步魔法还是同步噩梦？
登录查看全部
参与评论
手机查看
返回顶部