扫描二维码关注或者微信搜一搜：编程智域 前端至全栈交流与成长

发现1000+提升效率与开发的AI工具和实用程序：https://tools.cmdragon.cn/

（一）BackgroundTasks 基本用法

1.1 任务处理机制

通过 FastAPI 的 BackgroundTasks 类型，我们可以将非即时性操作（如发送邮件、日志记录等）从主请求处理流程中分离。系统架构原理如下：

请求处理流程：

graph TD
A[客户端请求] --> B[FastAPI主线程]
B --> C{即时操作?}
C -->|是| D[同步处理并返回响应]
C -->|否| E[添加至BackgroundTasks队列]
E --> F[后台Worker异步处理]
F --> G[邮件/日志等非即时操作]

这种机制的优势在于：

  • 响应时间减少 40%-60%（根据任务复杂度）
  • 支持同步/异步混合任务处理
  • 自动处理任务依赖关系

1.2 基础实现步骤

使用 pydantic2.5.2 和 fastapi0.104.0 的示例：

from fastapi import BackgroundTasks, FastAPI

from pydantic import BaseModel

app = FastAPI()

# 定义数据模型

class UserRegistration(BaseModel):

    username: str

    email: str

# 后台任务函数

def send_welcome_email(email: str):

    # 模拟邮件发送（实际需替换真实SMTP配置）

    print(f"Sending welcome email to {email}")

# 路由处理

@app.post("/register")

async def create_user(

    user: UserRegistration,

    background_tasks: BackgroundTasks

):

    # 添加后台任务

    background_tasks.add_task(send_welcome_email, user.email)

    return {"message": "Registration successful"}

关键实现要素：

  1. 注入 BackgroundTasks 参数到路由函数
  2. 通过 add_task 方法添加任务
  3. 任务函数支持同步/异步定义

（二）高级功能实现

2.1 依赖注入增强

结合依赖注入系统实现复用：

from typing import Annotated

from fastapi import Depends

def get_notification_service():

    # 模拟通知服务初始化

    return NotificationService()

@app.post("/order")

async def create_order(

    background_tasks: BackgroundTasks,

    notify_service: Annotated[NotificationService, Depends(get_notification_service)]

):

    background_tasks.add_task(

        notify_service.send_order_confirmation,

        order_id=123

    )

2.2 混合任务处理

同步与异步任务混合示例：

async def async_task_1():

    await asyncio.sleep(1)

def sync_task_2():

    time.sleep(2)

@app.get("/complex-task")

def complex_operation(background_tasks: BackgroundTasks):

    background_tasks.add_task(async_task_1)

    background_tasks.add_task(sync_task_2)

（三）测试与调试

3.1 单元测试示例

使用 pytest7.4.0 和 httpx0.25.0：

from fastapi.testclient import TestClient

def test_background_task():

    client = TestClient(app)

    with mock.patch("module.send_welcome_email") as mock_task:

        response = client.post("/register", json={

            "username": "testuser",

            "email": "test@example.com"

        })

        assert response.status_code == 200

        mock_task.assert_called_once_with("test@example.com")

3.2 集成测试要点

  • 使用 --reload 参数检测任务执行
  • 通过日志监控任务状态
  • 使用任务队列中间件（如 Celery）进行扩展

课后 Quiz

Q1：当需要确保后台任务在应用关闭前完成时，应该如何处理？

A：使用 lifespan 事件监听，在 shutdown 阶段等待任务完成。正确做法是注册应用生命周期钩子，在关闭时调用 BackgroundTasks 的等待方法。

Q2：后台任务中出现异常会导致主请求失败吗？

A：不会。后台任务异常会记录到日志但不会影响主请求响应，需要通过自定义错误处理中间件捕获。

常见报错处理

报错现象：后台任务未执行

原因分析：

  1. 路由函数未正确注入 BackgroundTasks 参数
  2. 任务函数存在未处理的异常
  3. 应用未正确配置异步支持

解决方案：

  1. 检查路由参数声明顺序
  2. 添加任务日志记录
  3. 使用 try/except 包裹任务代码
  4. 确认是否启用 ASGI 服务器（如 uvicorn）

余下文章内容请点击跳转至 个人博客页面 或者 扫码关注或者微信搜一搜：编程智域 前端至全栈交流与成长，阅读完整的文章：如何在FastAPI中让后台任务既高效又不会让你的应用崩溃？

往期文章归档：

免费好用的热门在线工具

如何在FastAPI中让后台任务既高效又不会让你的应用崩溃？的更多相关文章

  1. 如何在MySQL中查询每个分组的前几名【转】

    问题 在工作中常会遇到将数据分组排序的问题,如在考试成绩中,找出每个班级的前五名等. 在orcale等数据库中可以使用partition语句来解决,但在mysql中就比较麻烦了.这次翻译的文章就是专门 ...

  2. 如何在Word中排出漂亮的代码

    引言 学数学和计算机,当然还是用LaTeX排版技术文章更方便.但有时候还是迫不得已需要用Word写作,另外Word其实也有Word的好处,比如细节上的修改要比LaTeX方便. 从Matlab高亮代码复 ...

  3. 为何在查询中索引未被使用 (Doc ID 1549181.1)

        To Bottom * 为何在查询中索引未被使用 (Doc ID 1549181.1) To Bottom 文档内容 用途   排错步骤   高速检查   表上是否存在索引?   索引是否应该 ...

  4. 【神经网络与深度学习】如何在Caffe中配置每一个层的结构

    如何在Caffe中配置每一个层的结构 最近刚在电脑上装好Caffe,由于神经网络中有不同的层结构,不同类型的层又有不同的参数,所有就根据Caffe官网的说明文档做了一个简单的总结. 1. Vision ...

  5. 如何在CMDB中落地应用的概念？

    如何在CMDB中落地应用的概念? 我们前面讲了应用是整个微服务架构体系下运维的核心,而CMDB又是整个运维平台的基石.今天我就讲讲在CMDB中如何落地应用这个核心概念,以及如何建立应用集群分组的思路. ...

  6. 关于如何在C#中调用C++的DLL，以及如何在C++中调用C#的DLL

    一.关于如何在C#中调用C++的DLL,以及如何在C++中调用C#的DLL 注:clr指公共语言运行库 CLR是一门非常恶搞的语言,就好像是在C++里面写C#的文件一样,也就是一种所谓的"托 ...

  7. 我是如何在SQLServer中处理每天四亿三千万记录的

    首先声明,我只是个程序员,不是专业的DBA,以下这篇文章是从一个问题的解决过程去写的,而不是一开始就给大家一个正确的结果,如果文中有不对的地方,请各位数据库大牛给予指正,以便我能够更好的处理此次业务. ...

  8. 【Win 10 应用开发】在App所在的进程中执行后台任务

    在以往版本中,后台任务都是以独立的专用进程来运行,因此,定义后台任务代码的类型都要位于 Windows 运行时组件项目中. 不过,在14393中,SDK 作了相应的扩展,不仅支持以前的独立进程中运行后 ...

  9. 如何在SpringBoot中使用JSP ？但强烈不推荐，果断改Themeleaf吧

    做WEB项目,一定都用过JSP这个大牌.Spring MVC里面也可以很方便的将JSP与一个View关联起来,使用还是非常方便的.当你从一个传统的Spring MVC项目转入一个Spring Boot ...

  10. 如何在latex 中插入EPS格式图片

    如何在latex 中插入EPS格式图片 第一步:生成.eps格式的图片 1.利用visio画图,另存为pdf格式的图片 利用Adobe Acrobat裁边,使图片大小合适 另存为.eps格式,如下图所 ...

随机推荐

  1. K8s进阶之一文搞懂PV，PVC及SC

    前言 想了解Pod的基本存储,可以参考这篇文章:K8s新手系列之Pod的基本存储 概述 官方文档: 配置Pod使用PV进行存储:https://kubernetes.io/zh-cn/docs/tas ...

  2. ASP.NET Core之Razor Page相关

    cshtml一般是这样: @page @model IndexModel @{ ViewData["Title"] = "Home page"; } <d ...

  3. 用 Sidecar 容器为 .NET Core 应用做诊断和性能分析

    在微服务架构和云原生应用广泛采用的今天,.NET Core 应用被越来越多地部署在 Kubernetes 集群中.然而,一旦这些应用出现性能瓶颈,仅靠传统的日志和指标可能无法定位问题的根本原因. 从 ...

  4. Innosetup 安装 VC_redist 运行时库

    #普通安装vc_redis.x86.exe(会提示用户做出选择),在innosetup的[Run]属性中添加下面这一行 Filename: "{app}VC_redist.x86.exe&q ...

  5. 长短期记忆（LSTM）网络模型

    一.概述   长短期记忆(Long Short-Term Memory,LSTM)网络是一种特殊的循环神经网络(RNN),专门设计用于解决传统 RNN 在处理长序列数据时面临的梯度消失 / 爆炸问题, ...

  6. 计算机网络-TCP/IP知识点

    快速以太网数据帧有效载荷的最小长度为 46 字节(参考:Ethernet Frame Calculations) 实战 (2012 408考研真题 47)(15分)主机 H 通过快速以太网连接 Int ...

  7. DeepSeekMath -- GRPO

    Deepseek系列博客目录 Model 核心 Date DeepSeekLLM 探究LLM Scalling Law 2024.01 DeepSeekMath 提出GRPO 2024.04 Deep ...

  8. 记录.Net 8 发布增加 PublishTrimmed 裁剪选项，调用WMI 的ManagementObject 异常

    最近在做OTA的功能,需要获取到sn做一些业务的逻辑.我们自己实现的库里边的,大部分都是调用 System.Management 的 ManagementObjectSearcher 获取 Bios ...

  9. 基于 Paimon 的袋鼠云实时湖仓入湖实战剖析

    在当今数据驱动的时代,企业对数据的实施性能力提出了前所未有的高要求.为了应对这一挑战,构建高效.灵活且可扩展的实时湖仓成为数字化转型的关键.本文将深入探讨袋鼠云数栈如何通过三大核心实践--ChunJu ...

  10. 商品中心—17.缓存与DB一致性的技术文档

    大纲 1.缓存与数据库一致性服务的设计 2.缓存与数据库一致性服务的注解 3.缓存与数据库一致性服务的处理入口 4.缓存与数据库一致性服务的消费缓存消息 5.缓存与数据库一致性服务的消费检查 6.缓存 ...