FastAPI 基础入门-章节二（同步异步路由、多应用挂载、配置信息读取）

FastAPI 基础入门：从同步到异步，从配置到部署

FastAPI 是当前 Python Web 开发领域最具潜力的框架之一，其高性能、易用性与现代化特性吸引了大量开发者。本文将从基础入手，逐步讲解 FastAPI 的核心功能，包括同步与异步 API 端点路由、多应用挂载、Swagger UI 自定义配置以及应用配置信息的读取与缓存优化。通过本文，您将掌握构建高效、可扩展的 FastAPI 应用的核心技能。

---

同步和异步 API 端点路由

同步 API 端点路由

同步 API 端点是最常见的请求处理方式，适用于执行时间较短或不需要异步操作的场景。在 FastAPI 中，同步路由函数的定义非常直观，只需使用装饰器 @app.get()、@app.post() 等指定 HTTP 方法和路径即可。

示例代码：

from fastapi import FastAPI

app = FastAPI()

@app.get("/sync")
def sync_endpoint():
    # 模拟同步操作（例如数据库查询）
    data = "This is a synchronous response"
    return {
   
   "message": data}

在同步模式下，请求会阻塞当前线程直到函数执行完毕。这种方式适用于简单的业务逻辑，但若涉及 I/O 操作（如网络请求、数据库调用）或耗时较长的任务，可能会导致性能瓶颈。

异步 API 端点路由

FastAPI 支持异步编程，通过 async def 定义异步函数，并使用 await 关键字调用异步操作（如 aiohttp、httpx 或数据库的异步驱动）。异步路由的优势在于非阻塞式处理，允许服务器在等待 I/O 时处理其他请求，从而显著提升高并发场景下的吞吐量。

示例代码：

from fastapi import FastAPI
import httpx

app = FastAPI()

@app.get("/async")
async def async_endpoint():
    # 模拟异步网络请求
    async with httpx.AsyncClient() as client:
        response = await client.get("https://example.com")
    return {
   
   "message": "Async response", "status": response.status_code}

在异步模式下，函数执行过程中会释放线