最近在帮团队搭建一个内部API服务时对比了多个Python Web框架最终选择了FastAPI。它凭借其极致的性能、直观的异步支持和自动生成的交互式API文档让开发和调试效率大幅提升。如果你正在寻找一个能快速构建高性能API的现代Python框架或者想从Flask/Django转型那么这份FastAPI实战指南正是为你准备的。本文将带你从零开始在几个小时内掌握FastAPI的核心用法并完成一个包含用户认证、数据库操作和部署的完整项目无论是学生练手还是企业级开发都能直接复用。1. FastAPI 是什么为什么选择它在开始敲代码之前我们有必要理解FastAPI的设计哲学和它解决的问题。这能帮助你在后续开发中做出更合理的技术决策。1.1 核心概念与定位FastAPI 是一个用于构建 API 的现代、快速高性能的 Web 框架主要基于 Python 3.6 的类型提示Type Hints和标准 Python 类型。它并非一个全栈框架如Django而是一个专注于API开发的微框架类似Flask但其能力和开箱即用的特性远超传统微框架。简单来说你可以把它想象成“强化版的Flask”像 Flask 一样简单易用定义路由、处理请求的代码非常直观。像 Node.js 一样快基于 Starlette用于构建异步 Web 服务和 Pydantic用于数据验证性能堪比Go和Node.js。自带“说明书”自动生成交互式API文档Swagger UI 和 ReDoc无需额外编写。减少Bug利用Python类型提示在编码时就能获得编辑器的智能补全和类型检查很多错误在运行前就能发现。1.2 解决的核心痛点与优势为什么FastAPI能迅速流行它精准地解决了传统Python Web开发中的几个痛点开发速度慢需要手动编写大量文档且文档容易与代码不同步。FastAPI自动从你的代码和类型提示生成文档完全同步。数据验证繁琐需要写很多if...else来判断请求参数是否合法。FastAPI通过Pydantic模型自动进行请求和响应的数据验证、序列化。性能瓶颈同步框架在处理I/O密集型操作如数据库查询、调用外部API时会阻塞线程。FastAPI原生支持async/await异步编程能轻松处理高并发。学习曲线陡峭一些框架配置复杂。FastAPI的API设计非常Pythonic对于有Python基础的开发者来说几乎零学习成本。1.3 常见应用场景FastAPI非常适合构建RESTful API 后端服务为移动应用、前端单页应用React, Vue提供数据接口。微服务架构中的单个服务由于其轻量和高效是微服务的理想选择。实时应用结合WebSockets可以轻松构建聊天应用、实时通知系统。机器学习模型部署快速将训练好的模型包装成API服务供其他系统调用。内部工具和自动化脚本的HTTP接口。2. 环境准备与项目初始化“工欲善其事必先利其器”。让我们先搭建一个干净、可复现的开发环境。2.1 基础环境要求操作系统Windows 10/11, macOS, 或 Linux (如 Ubuntu)。本文命令以macOS/Linux为例Windows用户可在PowerShell或WSL中运行。Python 版本Python 3.7 及以上。FastAPI 强烈依赖新版本的类型提示特性。使用以下命令检查你的Python版本python --version # 或 python3 --version如果版本低于3.7请前往 python.org 下载安装最新版本。2.2 创建虚拟环境与安装依赖使用虚拟环境是Python项目的最佳实践它可以隔离不同项目的依赖避免版本冲突。创建项目目录并进入mkdir fastapi_crash_course cd fastapi_crash_course创建虚拟环境# 使用 venv (Python 3.3 内置) python3 -m venv venv激活虚拟环境# macOS/Linux source venv/bin/activate # Windows (CMD) # venv\Scripts\activate.bat # Windows (PowerShell) # venv\Scripts\Activate.ps1激活后命令行提示符前通常会显示(venv)。安装核心依赖我们将安装FastAPI本体以及一个ASGI服务器用于运行应用。这里选择高性能的uvicorn。pip install fastapi uvicorn这个命令会同时安装fastapi,uvicorn, 以及它们依赖的starlette和pydantic。2.3 验证安装与第一个程序创建一个最简单的应用来验证环境是否正常。创建主程序文件main.py# main.py from fastapi import FastAPI # 创建 FastAPI 应用实例 app FastAPI() # 定义一个根路径的 GET 请求处理函数 app.get(/) def read_root(): return {message: Hello, FastAPI!} # 定义一个带路径参数的 GET 请求处理函数 app.get(/items/{item_id}) def read_item(item_id: int, q: str None): return {item_id: item_id, q: q}启动开发服务器 在项目根目录下运行uvicorn main:app --reloadmain指模块文件main.py。app指在main.py中创建的FastAPI实例对象。--reload让服务器在代码更改后自动重启仅用于开发。验证运行 打开浏览器访问http://127.0.0.1:8000你应该看到{message:Hello, FastAPI!}。 访问http://127.0.0.1:8000/items/42?qtest你应该看到{item_id:42,q:test}。 访问http://127.0.0.1:8000/docs你会看到自动生成的Swagger UI 交互式文档可以在这里直接测试API接口3. 核心语法与功能拆解现在你已经成功运行了第一个FastAPI应用。接下来我们深入其核心功能理解每一部分是如何工作的。3.1 路径操作与HTTP方法在FastAPI中通过路径操作装饰器来声明路由。它们直接对应于HTTP方法。from fastapi import FastAPI app FastAPI() app.get(/items/) # 处理 GET 请求 async def read_items(): return [{item: Foo}, {item: Bar}] app.post(/items/) # 处理 POST 请求 async def create_item(item: dict): # 处理创建逻辑 return item app.put(/items/{item_id}) # 处理 PUT 请求 async def update_item(item_id: int, item: dict): # 处理更新逻辑 return {item_id: item_id, **item} app.delete(/items/{item_id}) # 处理 DELETE 请求 async def delete_item(item_id: int): # 处理删除逻辑 return {message: fItem {item_id} deleted}关键点app.get(...)等装饰器将下面的函数注册为对应路径和HTTP方法的处理器。路径中的{item_id}是路径参数。函数可以定义为普通的def或异步的async def。如果函数内部有await调用如异步数据库操作必须使用async def。3.2 请求参数处理路径、查询、请求体FastAPI 能智能地区分不同类型的参数。路径参数作为URL路径的一部分。app.get(/users/{user_id}) async def get_user(user_id: int): # FastAPI会自动将字符串转换为int return {user_id: user_id}查询参数URL中?后面的键值对函数中未声明为路径参数的参数默认被视为查询参数。app.get(/items/) async def read_items(skip: int 0, limit: int 10): # 访问 /items/?skip20limit5 return {skip: skip, limit: limit}skip和limit都有默认值因此是可选的。请求体Body用于接收客户端发送的JSON数据通常用于POST、PUT请求。这里需要引入Pydantic模型。from pydantic import BaseModel from typing import Optional class Item(BaseModel): name: str description: Optional[str] None # 可选字段默认为None price: float tax: Optional[float] None app.post(/items/) async def create_item(item: Item): # 声明item参数类型为Item模型 # FastAPI会自动验证请求体JSON是否符合Item模型 # 你可以直接使用 item.name, item.price 等属性 item_dict item.dict() if item.tax: price_with_tax item.price item.tax item_dict.update({price_with_tax: price_with_tax}) return item_dictPydantic模型的威力自动验证如果请求体缺少必需的name字段或price是字符串而不是数字FastAPI会自动返回422错误并详细指出错误位置。数据转换将接收的JSON数据转换为Python对象Item实例。编辑器支持在函数内写item.时编辑器能智能提示name,description等属性。生成文档自动在Swagger UI中生成JSON Schema。3.3 响应模型与状态码你可以控制API返回的数据结构和HTTP状态码。响应模型使用response_model参数确保返回的数据符合指定的Pydantic模型并过滤掉模型未定义的字段。class UserOut(BaseModel): username: str email: str app.post(/users/, response_modelUserOut) async def create_user(user: UserIn): # 假设UserIn包含password字段 # 处理用户创建... # 返回的字典会被自动用UserOut模型验证和过滤 # 即使内部处理了password返回给客户端的数据也不会包含它 return user状态码使用status_code参数设置成功响应时的HTTP状态码。from fastapi import status app.post(/items/, status_codestatus.HTTP_201_CREATED) async def create_item(item: Item): # 创建成功后返回201状态码而非默认的200 return item3.4 依赖注入系统依赖注入是FastAPI一个极其强大的特性它让你可以声明某个路径操作函数所依赖的“组件”FastAPI会自动处理这些组件的创建和注入。常用于共享数据库连接。验证身份认证如JWT Token。权限检查。分页参数。from fastapi import Depends, FastAPI, HTTPException, Header app FastAPI() # 1. 定义一个简单的依赖函数 async def common_parameters(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_parameters)): # commons 会自动被注入为 common_parameters 函数的返回值 return commons # 2. 用于认证的依赖项 async def verify_token(x_token: str Header(...)): # 要求请求头中必须有X-Token if x_token ! fake-super-secret-token: raise HTTPException(status_code400, detailX-Token header invalid) return x_token app.get(/secure-items/, dependencies[Depends(verify_token)]) async def read_secure_items(): # 该端点必须先通过verify_token依赖项的验证 return {data: sensitive data}依赖注入使代码更清晰、更可测试并且便于复用逻辑。4. 完整实战案例构建一个待办事项API理论讲得再多不如动手实践。我们来构建一个功能完整的待办事项TodoAPI涵盖CRUD操作、数据库连接和简单的用户认证。4.1 项目结构与依赖首先安装额外的依赖我们需要一个异步数据库驱动和ORM。这里选择SQLAlchemy和异步驱动asyncpg用于PostgreSQL以及python-multipart用于处理表单数据虽然本例不用但常需。pip install sqlalchemy asyncpg python-multipart项目结构如下fastapi_todo_project/ ├── app/ │ ├── __init__.py │ ├── main.py # FastAPI 应用实例和路由 │ ├── database.py # 数据库连接配置 │ ├── models.py # SQLAlchemy 数据模型 │ ├── schemas.py # Pydantic 模型请求/响应体 │ ├── crud.py # 数据库增删改查操作 │ └── dependencies.py # 依赖项如获取当前用户 ├── .env # 环境变量数据库URL等 └── requirements.txt4.2 配置数据库与模型数据库配置(app/database.py)from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine from sqlalchemy.orm import sessionmaker, declarative_base # 从环境变量读取数据库URL示例postgresqlasyncpg://user:passwordlocalhost/dbname DATABASE_URL postgresqlasyncpg://postgres:passwordlocalhost/todo_db # 创建异步引擎 engine create_async_engine(DATABASE_URL, echoTrue) # echoTrue 打印SQL日志生产环境应关闭 # 创建异步会话工厂 AsyncSessionLocal sessionmaker( engine, class_AsyncSession, expire_on_commitFalse ) # 声明基类用于创建数据模型 Base declarative_base() # 依赖项获取数据库会话 async def get_db(): async with AsyncSessionLocal() as session: yield session数据模型(app/models.py)from sqlalchemy import Column, Integer, String, Boolean, ForeignKey from sqlalchemy.orm import relationship from .database import Base class User(Base): __tablename__ users id Column(Integer, primary_keyTrue, indexTrue) username Column(String, uniqueTrue, indexTrue, nullableFalse) email Column(String, uniqueTrue, indexTrue, nullableFalse) hashed_password Column(String, nullableFalse) is_active Column(Boolean, defaultTrue) # 关系 items relationship(TodoItem, back_populatesowner) class TodoItem(Base): __tablename__ todo_items id Column(Integer, primary_keyTrue, indexTrue) title Column(String, indexTrue, nullableFalse) description Column(String, indexTrue) completed Column(Boolean, defaultFalse) owner_id Column(Integer, ForeignKey(users.id)) # 关系 owner relationship(User, back_populatesitems)Pydantic模式(app/schemas.py)from pydantic import BaseModel, EmailStr from typing import Optional, List # 用户相关 class UserBase(BaseModel): username: str email: EmailStr class UserCreate(UserBase): password: str class UserInDB(UserBase): id: int is_active: bool class Config: orm_mode True # 允许从ORM对象创建Pydantic模型 # 待办事项相关 class TodoItemBase(BaseModel): title: str description: Optional[str] None completed: bool False class TodoItemCreate(TodoItemBase): pass class TodoItemUpdate(BaseModel): title: Optional[str] None description: Optional[str] None completed: Optional[bool] None class TodoItem(TodoItemBase): id: int owner_id: int class Config: orm_mode True4.3 实现核心CRUD操作创建数据库操作层 (app/crud.py)from sqlalchemy.ext.asyncio import AsyncSession from sqlalchemy import select from . import models, schemas from passlib.context import CryptContext pwd_context CryptContext(schemes[bcrypt], deprecatedauto) # --- 用户CRUD --- async def get_user_by_email(db: AsyncSession, email: str): result await db.execute(select(models.User).where(models.User.email email)) return result.scalar_one_or_none() async def create_user(db: AsyncSession, user: schemas.UserCreate): hashed_password pwd_context.hash(user.password) db_user models.User( usernameuser.username, emailuser.email, hashed_passwordhashed_password ) db.add(db_user) await db.commit() await db.refresh(db_user) # 刷新以获取id等数据库生成的值 return db_user # --- 待办事项CRUD --- async def get_todo_items(db: AsyncSession, user_id: int, skip: int 0, limit: int 100): result await db.execute( select(models.TodoItem) .where(models.TodoItem.owner_id user_id) .offset(skip) .limit(limit) ) return result.scalars().all() async def create_user_todo_item(db: AsyncSession, todo_item: schemas.TodoItemCreate, user_id: int): db_item models.TodoItem(**todo_item.dict(), owner_iduser_id) db.add(db_item) await db.commit() await db.refresh(db_item) return db_item async def update_todo_item(db: AsyncSession, item_id: int, user_id: int, item_update: schemas.TodoItemUpdate): result await db.execute( select(models.TodoItem) .where(models.TodoItem.id item_id, models.TodoItem.owner_id user_id) ) db_item result.scalar_one_or_none() if not db_item: return None update_data item_update.dict(exclude_unsetTrue) # 只更新提供的字段 for field, value in update_data.items(): setattr(db_item, field, value) await db.commit() await db.refresh(db_item) return db_item async def delete_todo_item(db: AsyncSession, item_id: int, user_id: int): result await db.execute( select(models.TodoItem) .where(models.TodoItem.id item_id, models.TodoItem.owner_id user_id) ) db_item result.scalar_one_or_none() if not db_item: return False await db.delete(db_item) await db.commit() return True4.4 实现认证与路由认证依赖项(app/dependencies.py)from fastapi import Depends, HTTPException, status from fastapi.security import OAuth2PasswordBearer from jose import JWTError, jwt from passlib.context import CryptContext from sqlalchemy.ext.asyncio import AsyncSession from . import crud, models, schemas from .database import get_db import os from datetime import datetime, timedelta # 从环境变量读取密钥和算法 SECRET_KEY os.getenv(SECRET_KEY, your-secret-key-change-in-production) ALGORITHM HS256 ACCESS_TOKEN_EXPIRE_MINUTES 30 pwd_context CryptContext(schemes[bcrypt], deprecatedauto) oauth2_scheme OAuth2PasswordBearer(tokenUrltoken) # 定义token获取端点 def verify_password(plain_password, hashed_password): return pwd_context.verify(plain_password, hashed_password) def create_access_token(data: dict, expires_delta: timedelta None): to_encode data.copy() if expires_delta: expire datetime.utcnow() expires_delta else: expire datetime.utcnow() timedelta(minutes15) to_encode.update({exp: expire}) encoded_jwt jwt.encode(to_encode, SECRET_KEY, algorithmALGORITHM) return encoded_jwt async def get_current_user(token: str Depends(oauth2_scheme), db: AsyncSession Depends(get_db)): credentials_exception HTTPException( status_codestatus.HTTP_401_UNAUTHORIZED, detailCould not validate credentials, headers{WWW-Authenticate: Bearer}, ) try: payload jwt.decode(token, SECRET_KEY, algorithms[ALGORITHM]) username: str payload.get(sub) if username is None: raise credentials_exception except JWTError: raise credentials_exception user await crud.get_user_by_email(db, emailusername) if user is None: raise credentials_exception return user主应用与路由(app/main.py)from fastapi import FastAPI, Depends, HTTPException, status from fastapi.security import OAuth2PasswordRequestForm from sqlalchemy.ext.asyncio import AsyncSession from datetime import timedelta from . import crud, models, schemas, dependencies from .database import engine, get_db from .dependencies import create_access_token, ACCESS_TOKEN_EXPIRE_MINUTES, verify_password app FastAPI(titleTodo API, version1.0.0) # 创建数据库表生产环境应使用Alembic迁移 app.on_event(startup) async def startup(): async with engine.begin() as conn: # await conn.run_sync(models.Base.metadata.drop_all) # 重置表谨慎使用 await conn.run_sync(models.Base.metadata.create_all) # 用户注册 app.post(/users/, response_modelschemas.UserInDB, status_codestatus.HTTP_201_CREATED) async def create_user(user: schemas.UserCreate, db: AsyncSession Depends(get_db)): db_user await crud.get_user_by_email(db, emailuser.email) if db_user: raise HTTPException(status_code400, detailEmail already registered) return await crud.create_user(dbdb, useruser) # 用户登录获取Token app.post(/token) async def login_for_access_token(form_data: OAuth2PasswordRequestForm Depends(), db: AsyncSession Depends(get_db)): user await crud.get_user_by_email(db, emailform_data.username) # OAuth2表单用username字段传邮箱 if not user or not verify_password(form_data.password, user.hashed_password): raise HTTPException( status_codestatus.HTTP_401_UNAUTHORIZED, detailIncorrect username or password, headers{WWW-Authenticate: Bearer}, ) access_token_expires timedelta(minutesACCESS_TOKEN_EXPIRE_MINUTES) access_token create_access_token( data{sub: user.email}, expires_deltaaccess_token_expires ) return {access_token: access_token, token_type: bearer} # 获取当前用户的待办事项 app.get(/todos/, response_modellist[schemas.TodoItem]) async def read_todos( skip: int 0, limit: int 100, current_user: models.User Depends(dependencies.get_current_user), db: AsyncSession Depends(get_db) ): todos await crud.get_todo_items(db, user_idcurrent_user.id, skipskip, limitlimit) return todos # 创建新的待办事项 app.post(/todos/, response_modelschemas.TodoItem, status_codestatus.HTTP_201_CREATED) async def create_todo( todo: schemas.TodoItemCreate, current_user: models.User Depends(dependencies.get_current_user), db: AsyncSession Depends(get_db) ): return await crud.create_user_todo_item(dbdb, todo_itemtodo, user_idcurrent_user.id) # 更新待办事项 app.put(/todos/{item_id}, response_modelschemas.TodoItem) async def update_todo( item_id: int, todo_update: schemas.TodoItemUpdate, current_user: models.User Depends(dependencies.get_current_user), db: AsyncSession Depends(get_db) ): db_item await crud.update_todo_item(db, item_iditem_id, user_idcurrent_user.id, item_updatetodo_update) if db_item is None: raise HTTPException(status_code404, detailTodo item not found) return db_item # 删除待办事项 app.delete(/todos/{item_id}) async def delete_todo( item_id: int, current_user: models.User Depends(dependencies.get_current_user), db: AsyncSession Depends(get_db) ): success await crud.delete_todo_item(db, item_iditem_id, user_idcurrent_user.id) if not success: raise HTTPException(status_code404, detailTodo item not found) return {message: Todo item deleted successfully}4.5 运行与测试启动应用在项目根目录运行uvicorn app.main:app --reload --host 0.0.0.0 --port 8000使用交互式文档测试打开http://127.0.0.1:8000/docs。首先点击POST /users/尝试创建一个用户。然后点击POST /token使用刚创建的用户名邮箱和密码获取访问令牌。点击右上角的Authorize按钮输入Bearer 你的token进行认证。现在你可以测试/todos/下的所有需要认证的端点了。这个项目虽然简单但涵盖了FastAPI的核心概念路径操作、Pydantic模型、依赖注入、数据库异步操作、JWT认证。你可以在此基础上扩展更多功能如分页、过滤、文件上传等。5. 常见问题与排查思路在实际开发中你可能会遇到一些典型问题。下面列出一些高频问题及其解决方案。问题现象常见原因解决思路启动报错ModuleNotFoundError: No module named fastapi虚拟环境未激活或依赖未安装。1. 确认命令行前有(venv)提示。2. 运行pip list检查是否已安装fastapi和uvicorn。3. 在项目根目录重新安装依赖pip install -r requirements.txt。访问/docs或/redoc页面空白或报错浏览器缓存或网络问题也可能是前端资源加载失败。1. 尝试硬刷新浏览器CtrlF5。2. 检查浏览器控制台F12是否有JavaScript错误。3. 确保使用的FastAPI版本较新。4. 本地开发时可能是网络问题可暂时忽略不影响API功能。POST请求返回422 Unprocessable Entity请求体数据不符合Pydantic模型定义。1. 查看返回的错误详情它会明确指出哪个字段类型错误或缺失。2. 检查前端发送的JSON格式是否正确字段名是否匹配。3. 在Swagger UI上测试确保模型定义无误。数据库操作报异步错误如sqlalchemy.exc.MissingGreenlet在同步函数中调用了异步方法或数据库会话使用不当。1. 确保所有涉及数据库操作的路径函数都定义为async def。2. 确保使用AsyncSession和await执行查询。3. 检查依赖项get_db是否正确使用了async with。依赖注入的函数参数不被识别依赖项函数签名错误或未正确使用Depends()。1. 依赖项函数本身可以接收路径操作函数能接收的所有参数如查询参数、请求体等。2. 在路径操作函数中使用 Depends(dependency_function)来声明依赖。3. 确保依赖项返回你需要的值。JWT Token认证总是失败Token生成或验证的密钥、算法不一致或Token已过期。1. 确保生成Token (create_access_token) 和验证Token (jwt.decode) 使用相同的SECRET_KEY和ALGORITHM。2. 检查Token是否在请求头的Authorization: Bearer token中正确传递。3. 检查Token过期时间设置。生产环境性能不佳未使用生产级ASGI服务器或同步阻塞操作过多。1. 使用uvicorn配合gunicorn部署如gunicorn -k uvicorn.workers.UvicornWorker。2. 确保所有I/O操作数据库、外部API调用都使用异步驱动和await。3. 考虑使用连接池管理数据库连接。6. 最佳实践与工程建议掌握了基础之后遵循一些最佳实践能让你的FastAPI项目更健壮、更易维护。6.1 项目结构与组织按功能模块拆分不要把所有代码都堆在main.py里。像我们实战案例一样将路由、模型、数据库逻辑、依赖项等分到不同文件。使用路由APIRouter当应用变大时使用fastapi.APIRouter来组织不同模块的路由最后在main.py中include_router。这使代码结构更清晰。# app/routers/items.py from fastapi import APIRouter router APIRouter(prefix/items, tags[items]) router.get(/) async def read_items(): ... # app/main.py from .routers import items app.include_router(items.router)6.2 配置管理使用环境变量永远不要将数据库密码、API密钥等敏感信息硬编码在代码中。使用python-dotenv库从.env文件或系统环境变量中读取。pip install python-dotenv# .env 文件 DATABASE_URLpostgresqlasyncpg://user:passlocalhost/db SECRET_KEYyour-super-secret-key# 在配置文件中 from pydantic_settings import BaseSettings class Settings(BaseSettings): database_url: str secret_key: str class Config: env_file .env settings Settings()6.3 错误处理与日志自定义异常处理器使用app.exception_handler来统一处理特定异常返回结构化的错误信息。from fastapi import Request, HTTPException from fastapi.responses import JSONResponse app.exception_handler(HTTPException) async def http_exception_handler(request: Request, exc: HTTPException): return JSONResponse( status_codeexc.status_code, content{message: exc.detail, error_code: CUSTOM_ERROR}, )记录日志使用Python标准库logging记录应用运行信息、错误和请求详情便于排查问题。6.4 安全与性能输入验证与清理始终信任Pydantic模型进行输入验证。对于字符串注意防范SQL注入SQLAlchemy已处理和XSS攻击在返回HTML时需转义。使用HTTPS在生产环境务必使用HTTPS。可以使用反向代理如Nginx处理SSL/TLS终止。异步无处不在尽可能使用异步数据库驱动如asyncpg,aiomysql和异步HTTP客户端如httpx避免阻塞事件循环。启用CORS如果API被前端应用调用需要配置CORS。from fastapi.middleware.cors import CORSMiddleware app.add_middleware( CORSMiddleware, allow_origins[http://localhost:3000], # 前端地址 allow_credentialsTrue, allow_methods[*], allow_headers[*], )6.5 测试与部署编写测试使用pytest和httpx编写API测试。FastAPI的TestClient让测试变得简单。from fastapi.testclient import TestClient from .main import app client TestClient(app) def test_read_main(): response client.get(/) assert response.status_code 200生产部署不要使用uvicorn main:app --reload直接运行。推荐组合Gunicorn Uvicorn Workergunicorn -k uvicorn.workers.UvicornWorker -w 4 app.main:appDocker容器化编写Dockerfile便于在不同环境一致地运行。反向代理使用Nginx或Traefik作为反向代理处理静态文件、负载均衡和SSL。通过以上步骤你不仅学会了FastAPI的基本用法还掌握了一个接近生产可用的项目结构和一系列最佳实践。接下来你可以尝试为这个Todo API添加更多功能比如文件上传、WebSocket实时同步、更复杂的权限系统或者将其部署到云服务器上。FastAPI的官方文档非常详尽是继续深入学习的绝佳资源。动手实践是掌握任何框架的最佳途径现在就基于这个项目开始你的探索吧。如果在实践中遇到具体问题欢迎在社区交流讨论。
