关于fastapi框架的异步

### FastAPI 框架中的异步编程指南与示例 FastAPI 是一个现代、快速（高性能）的Web框架，用于构建API，基于Python类型提示。该框架支持异步操作，这使得开发人员可以编写高效的非阻塞代码。 #### 使用 `async` 和 `await` 为了实现异步功能，在定义路径操作函数时应使用关键字 `async def` 来声明它们为协程(coroutine)，并在调用其他异步方法时使用 `await` 关键字[^3]： ```python from fastapi import FastAPI app = FastAPI() @app.get("/items/{item_id}") async def read_item(item_id: int): await some_async_function() return {"item_id": item_id} ``` 这里假设存在名为 `some_async_function()` 的异步函数来模拟实际业务逻辑处理过程。 #### 异步数据库交互 当涉及到像读取或写入这样的I/O密集型任务时，推荐采用异步驱动的数据访问库，例如 Tortoise ORM 或 SQLAlchemy 2.0+ 版本。下面是一个简单的例子展示如何利用 Motor 进行 MongoDB 数据库查询: ```python from motor.motor_asyncio import AsyncIOMotorClient from pydantic import BaseModel class Item(BaseModel): name: str description: str | None = None client = AsyncIOMotorClient('mongodb://localhost:27017') db = client.test_database @app.post('/create-item/', response_model=Item) async def create_item(item: Item): result = await db.items.insert_one(item.dict()) created_item = await db.items.find_one({'_id': result.inserted_id}) return created_item ``` 此段代码展示了创建新文档并立即检索刚插入记录的过程。 #### 并发执行多个请求 有时可能希望并发运行几个独立的任务而不必等待每一个完成后再继续下一个；这时就可以借助 Python 内置模块 asyncio 提供的功能——gather() 函数来达到目的: ```python import asyncio async def fetch_data(url): # Simulate network delay with sleep. await asyncio.sleep(1) return {'data': f'Fetched from {url}'} @app.get('/fetch-multiple/') async def fetch_multiple(): urls = ['http://example.com', 'https://another-site.org'] results = await asyncio.gather(*[fetch_data(url) for url in urls]) return results ``` 上述实例中，两个不同的URL被同时抓取数据，并最终一起返回给客户端。