Python构建数据API：FastAPI快速入门指南

使用 FastAPI可以快速构建高性能的数据API。首先安装Fastapi和Uvicorn并创建基础结构，接着设计GET和POST接口实现数据读写，然后通过SQLAlchemy连接数据库提供真实数据，最后采用Gunicorn或Docker部署上线以确保性能与可移植性。

想快速用 Python 构建一个数据 API？FastAPI 是个不错的选择。它基于现代 Python 类型提示，开发速度快、性能高，而且自带交互式文档，特别适合做数据接口服务。

下面从几个实用角度出发，讲讲怎么用 FastAPI 快速搭建一个数据 API。

1. 安装与基础结构

首先确保你已经安装了 Python（建议 3.8+），然后安装 FastAPI 和 Uvicorn：

pip install fastapi uvicorn

创建一个 Python 文件，比如 main.py，写入以下内容：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "欢迎使用 FastAPI"}

启动服务只需要运行：

uvicorn main:app --reload

访问 http://localhost:8000 就能看到返回的 JSON 数据。再打开 http://localhost:8000/docs，就能看到自动生成的交互式 API 文档，非常方便调试。

2. 接口设计：GET 和 POST 都能轻松搞定

假设你要做一个获取用户信息的接口，可以这样写：

@app.get("/users/{user_id}")
def read_user(user_id: int, q: str = None):
    return {"user_id": user_id, "q": q}

这个接口接收路径参数 user_id 和可选查询参数 q，返回一个 JSON 对象。

如果你需要接收 JSON 数据，比如新增用户，可以用 POST 方法：

from pydantic import BaseModel

class UserCreate(BaseModel):
    name: str
    email: str

@app.post("/users/")
def create_user(user: UserCreate):
    return {"status": "用户已创建", "user": user}

POST 请求体里需要传入符合 UserCreate 模型的数据，否则会自动报错，类型验证这块 FastAPI 做得很好。

3. 连接数据库提供真实数据

实际项目中，API 肯定要和数据库打交道。以 SQLite 为例，你可以使用 SQLAlchemy 来操作：

安装依赖：

pip install sqlalchemy

配置数据库连接后，就可以在接口中调用数据库了。例如：

from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker

engine = create_engine("sqlite:///./test.db")
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

@app.get("/items/")
def read_items():
    db = SessionLocal()
    # 假设这里执行了查询
    result = db.execute("SELECT * FROM items LIMIT 10").fetchall()
    return {"data": result}

当然，更规范的做法是把数据库逻辑抽离成单独模块，避免接口函数太臃肿。这部分可以根据项目规模灵活处理。

4. 部署上线别忘了这些细节

当你本地开发完成，准备部署时，有几点需要注意：

• 不要用 --reload 模式上线，会影响性能
• 推荐用 Nginx + Gunicorn/Uvicorn 的组合来部署
• 可以考虑用 Docker 打包应用，便于迁移和版本控制
• 如果需要 HTTPS，记得配好反向代理或 SSL 证书

比如用 Gunicorn 启动多个 worker：

gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app

这样可以在生产环境中获得更好的并发支持。

基本上就这些。FastAPI 上手快、功能强，只要熟悉 Python 和基本 Web 开发概念，就能很快搭出一个高效的数据 API。