• FastAPI, 一个神奇的 Python 库

FastAPI, 一个神奇的 Python 库

2025-06-09 10:37:03 栏目:宝塔面板 4 阅读

FastAPI 是一个用于构建 API 的现代、快速(高性能)的 web 框架,使用 Python 并基于标准的 Python类型提示。

安装

安装 FastAPI 很简单,这里我们使用 pip 命令来安装。

pip install fastapi

另外我们还需要一个 ASGI 服务器,生产环境可以使用 Uvicorn 或者 Hypercorn

pip install uvicorn[standard]

资料:

  • FastAPI 文档:https://fastapi.tiangolo.com/zh/
  • FastAPI 源码:https://github.com/tiangolo/fastapi

简单示例

# main.py

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

启动服务:

uvicorn main:app --reload
  • --reload:开发时自动重载(生产环境移除)
  • 访问:http://localhost:8000

关键功能

(1) 路径参数和查询参数

  • {user_id}:路径参数(必须)
  • limit 和 skip:查询参数(可选,带默认值)
@app.get("/users/{user_id}")
async def read_user(user_id: int, 
                    limit: int = 10, 
                    skip: int = 0):
  return {"user_id": user_id, "limit": limit, "skip": skip}

(2) 请求体(POST/PUT)

使用 Pydantic 模型验证数据:

from pydantic import BaseModel

class Item(BaseModel):
    name: str
    description: str = None
    price: float
    tax: float = None

@app.post("/items/")
async def create_item(item: Item):
    return {"item": item.dict()}

(3) 自动文档

  • Swagger UI:http://localhost:8000/docs
  • ReDoc:http://localhost:8000/redoc

(4) 异步支持

@app.get("/slow-endpoint")
async def slow_operation():
    # 如数据库查询
    await some_async_task() 
    return {"status": "done"}

进阶功能

(1) 依赖注入

复用代码逻辑(如认证、数据库连接)。

from fastapi import Depends

def common_params(q: str = None, skip: int = 0, limit: int = 100):
    return {"q": q, "skip": skip, "limit": limit}

@app.get("/items/")
async def read_items(commons: dict = Depends(common_params)):
    return commons

(2) 中间件

处理请求前/后的逻辑(如 CORS、日志)。

from fastapi.middleware.cors import CORSMiddleware

app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_methods=["*"],
)

(3) WebSocket 支持

@app.websocket("/ws")
async def websocket_endpoint(websocket: WebSocket):
    await websocket.accept()
    while True:
        data = await websocket.receive_text()
        await websocket.send_text(f"Message: {data}")

(4) 后台任务

执行无需即时响应的操作(如发送邮件、短信)

from fastapi import BackgroundTasks

def log_task(message: str):
    with open("log.txt", "a") as f:
        f.write(message)

@app.post("/send-email")
async def send_email(background_tasks: BackgroundTasks):
    background_tasks.add_task(log_task, "Email sent")
    return {"status": "ok"}

适用场景

  • 构建高性能 REST API
  • 微服务后端
  • 实时应用(WebSocket)
  • 结合sqlalchemy进行 web 开发

本文地址:https://www.yitenyun.com/277.html

搜索文章

Tags

数据库 API FastAPI Calcite 电商系统 MySQL 数据同步 ACK 双主架构 循环复制 Web 应用 异步数据库 序列 核心机制 生命周期 Deepseek 宝塔面板 Linux宝塔 Docker JumpServer JumpServer安装 堡垒机安装 Linux安装JumpServer esxi esxi6 root密码不对 无法登录 web无法登录 Windows Windows server net3.5 .NET 安装出错 宝塔面板打不开 宝塔面板无法访问 SSL 堡垒机 跳板机 HTTPS Windows宝塔 Mysql重置密码 无法访问宝塔面板 HTTPS加密 连接控制 机制 查看硬件 Linux查看硬件 Linux查看CPU Linux查看内存 ES 协同 修改DNS Centos7如何修改DNS scp Linux的scp怎么用 scp上传 scp下载 scp命令 防火墙 服务器 黑客 Serverless 无服务器 语言 Oracle 处理机制 存储 Spring SQL 动态查询 Linux 安全 RocketMQ 长轮询 配置 加密 场景 Rsync MySQL 9.3 缓存方案 缓存架构 缓存穿透 网络架构 工具 网络配置 开源 PostgreSQL 存储引擎 HexHub Canal 架构 InnoDB 信息化 智能运维 日志文件 MIXED 3 响应模型 单点故障 B+Tree ID 字段 线上 库存 预扣 索引 数据 业务 数据库锁 监控 聚簇 非聚簇 AI 助手 GreatSQL Hash 字段 分库 分表 Redis 自定义序列化 云原生 Redis 8.0 openHalo DBMS 管理系统 SpringAI 优化 万能公式 分页查询 OB 单机版 prometheus Alert ​Redis 机器学习 推荐模型 SVM Embedding 数据集成工具 SQLite Redka SQLite-Web 数据库管理工具 sqlmock sftp 服务器 参数 共享锁 PostGIS 系统 SQLark 虚拟服务器 虚拟机 内存 RDB AOF 排行榜 排序 查询 向量数据库 大模型 不宕机 自动重启 运维 同城 双活 容器化 缓存 Postgres OTel Iceberg • 索引 • 数据库 Netstat Linux 服务器 端口 技术 Doris SeaTunnel EasyExcel MySQL8 分布式架构 分布式锁​ 电商 聚簇索引 非聚簇索引 OAuth2 Token Entity 开发 Testcloud 云端自动化 IT AIOPS 数据备份 MongoDB 容器 数据类型 崖山 新版本 高可用 StarRocks 数据仓库 人工智能 推荐系统 分页 数据结构 redo log 重做日志 Python Web LRU Milvus 向量库 MVCC IT运维 池化技术 连接池 Caffeine CP 部署 mini-redis INCR指令 悲观锁 乐观锁 Ftp 流量 数据脱敏 加密算法 MCP 开放协议 Web 接口 微软 SQL Server AI功能 单线程 线程 磁盘架构 事务隔离 窗口 函数 字典 ZODB 速度 服务器中毒 R2DBC QPS 高并发 RAG HelixDB 原子性 PG DBA 对象 双引擎 Order 网络 Pottery 频繁 Codis 1 主库 SSH 引擎 性能 LLM Crash 代码 优化器 List 类型 dbt 数据转换工具 模型 工具链 Undo Log 意向锁 记录锁 事务同步 Redisson 锁芯 InfluxDB 发件箱模式 网络故障 传统数据库 向量化 UUIDv7 主键 线程安全 连接数 仪表盘 订单 INSERT COMPACT JOIN filelock 管理口 高效统计 今天这篇文章就跟大家 分页方案 排版