使用 FastAPI+FastCRUD 快速开发博客后端 API 接口

Python私教2025-11-07 16:34

作者：张大鹏 时间：2025 年 11 月 标签：FastAPI / SQLAlchemy / FastCRUD / 后端开发 / REST API

一、引言

在 FastAPI 项目中，我们通常会手写大量重复的 CRUD 逻辑（Create / Read / Update / Delete）。 例如，一个博客系统的后台往往包括：

  • 用户表（Users）
  • 文章表（Posts）
  • 评论表（Comments）

而每个模型都需要相似的增删改查接口。 这会导致重复的模板式代码 ------ 不仅冗余，还容易出错。

于是，我们引入一个强大的自动化工具：FastCRUD。

FastCRUD 是一个基于 FastAPI + SQLAlchemy 2.0 的开源库，可以：

  • 🔧 自动生成 CRUD 路由（无需手写重复接口）
  • ⚡ 全异步支持（AsyncSession + async engine）
  • 🔍 内建分页、排序、关联查询（join）
  • 🧩 与 Pydantic 2.x 完美集成

下面我们将用它一步步构建一个简洁高效的博客后端 API。

二、项目结构设计

我们将构建以下结构：

bash 复制代码 
fastcrud_blog/
│
├── main.py              # FastAPI 启动入口
├── database.py          # 数据库配置（engine, session）
├── models.py            # SQLAlchemy ORM 模型
├── schemas.py           # Pydantic 模型
├── routers/
│   ├── users.py
│   ├── posts.py
│   └── comments.py
└── requirements.txt

环境要求：

bash 复制代码 
Python >= 3.9
FastAPI >= 0.110
SQLAlchemy >= 2.0
FastCRUD >= 0.1.4

安装依赖：

bash 复制代码 
pip install fastapi[all] sqlalchemy fastcrud pydantic

三、配置数据库

文件：database.py

python 复制代码 
from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
from sqlalchemy.orm import sessionmaker

DATABASE_URL = "sqlite+aiosqlite:///./blog.db"

engine = create_async_engine(DATABASE_URL, echo=True)
async_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)

async def get_session() -> AsyncSession:
    async with async_session() as session:
        yield session

四、定义数据模型

文件：models.py

python 复制代码 
from sqlalchemy.orm import DeclarativeBase, relationship
from sqlalchemy import Column, Integer, String, Text, ForeignKey

class Base(DeclarativeBase):
    pass

class User(Base):
    __tablename__ = "users"
    id = Column(Integer, primary_key=True)
    username = Column(String(50), unique=True, index=True)
    email = Column(String(100), unique=True)
    posts = relationship("Post", back_populates="author")

class Post(Base):
    __tablename__ = "posts"
    id = Column(Integer, primary_key=True)
    title = Column(String(200))
    content = Column(Text)
    author_id = Column(Integer, ForeignKey("users.id"))
    author = relationship("User", back_populates="posts")
    comments = relationship("Comment", back_populates="post")

class Comment(Base):
    __tablename__ = "comments"
    id = Column(Integer, primary_key=True)
    content = Column(Text)
    post_id = Column(Integer, ForeignKey("posts.id"))
    post = relationship("Post", back_populates="comments")

五、定义 Schema（Pydantic 模型）

文件：schemas.py

python 复制代码 
from pydantic import BaseModel
from typing import Optional

# User Schemas
class UserBase(BaseModel):
    username: str
    email: str

class UserCreate(UserBase):
    pass

class UserUpdate(BaseModel):
    email: Optional[str] = None

# Post Schemas
class PostBase(BaseModel):
    title: str
    content: str

class PostCreate(PostBase):
    author_id: int

class PostUpdate(BaseModel):
    title: Optional[str]
    content: Optional[str]

# Comment Schemas
class CommentBase(BaseModel):
    content: str

class CommentCreate(CommentBase):
    post_id: int

class CommentUpdate(BaseModel):
    content: Optional[str]

六、使用 FastCRUD 自动生成 CRUD 路由

6.1 用户接口

文件：routers/users.py

python 复制代码 
from fastapi import APIRouter
from fastcrud import crud_router
from models import User
from schemas import UserCreate, UserUpdate
from database import get_session

user_router = crud_router(
    session=get_session,
    model=User,
    create_schema=UserCreate,
    update_schema=UserUpdate,
    path="/users",
    tags=["Users"]
)

6.2 文章接口

文件：routers/posts.py

python 复制代码 
from fastcrud import crud_router
from models import Post
from schemas import PostCreate, PostUpdate
from database import get_session

post_router = crud_router(
    session=get_session,
    model=Post,
    create_schema=PostCreate,
    update_schema=PostUpdate,
    path="/posts",
    tags=["Posts"]
)

6.3 评论接口

文件：routers/comments.py

python 复制代码 
from fastcrud import crud_router
from models import Comment
from schemas import CommentCreate, CommentUpdate
from database import get_session

comment_router = crud_router(
    session=get_session,
    model=Comment,
    create_schema=CommentCreate,
    update_schema=CommentUpdate,
    path="/comments",
    tags=["Comments"]
)

七、整合主应用

文件：main.py

python 复制代码 
from fastapi import FastAPI
from models import Base
from database import engine
from routers.users import user_router
from routers.posts import post_router
from routers.comments import comment_router

app = FastAPI(title="FastCRUD Blog API")

@app.on_event("startup")
async def init_db():
    async with engine.begin() as conn:
        await conn.run_sync(Base.metadata.create_all)

app.include_router(user_router)
app.include_router(post_router)
app.include_router(comment_router)

启动服务：

bash 复制代码 
uvicorn main:app --reload

打开浏览器访问：

👉 http://127.0.0.1:8000/docs

你将看到自动生成的接口文档，包括：

  • POST /users/ 创建用户
  • GET /users/{id} 获取用户详情
  • POST /posts/ 发布文章
  • GET /comments/ 查看评论

FastCRUD 自动帮你生成了完整的 CRUD 逻辑、路径和 Pydantic 校验。

八、分页、排序与 Join

FastCRUD 的查询接口支持高级参数，例如：

python 复制代码 
from fastcrud import FastCRUD
from models import Post
from database import get_session
from schemas import PostCreate

post_crud = FastCRUD(Post)

@app.get("/posts/paginated")
async def list_posts(limit: int = 10, offset: int = 0, db=Depends(get_session)):
    return await post_crud.get_multi(db, limit=limit, offset=offset, sort_columns=["id"], sort_orders=["desc"])

支持 offset、cursor 分页与多字段排序，常用于后台文章列表或时间线接口。

九、扩展：加入权限验证

你可以在自动生成的路由外层包一层依赖注入。例如：

python 复制代码 
from fastapi import Depends, HTTPException
from fastcrud import crud_router
from dependencies import get_current_user  # 你自己定义的 JWT 验证逻辑

post_router = crud_router(
    session=get_session,
    model=Post,
    create_schema=PostCreate,
    update_schema=PostUpdate,
    path="/posts",
    tags=["Posts"],
    dependencies=[Depends(get_current_user)]
)

这样，所有 /posts/* 路径都将自动启用 JWT 验证。

十、总结与实践建议

优点 说明
🚀 高开发效率 自动生成 CRUD 端点，几乎不用手写基础逻辑
⚙️ 异步性能优秀 完美契合 FastAPI 异步架构
🧠 可扩展性强 可组合 FastCRUD 与自定义逻辑
📦 易于维护 统一 CRUD 模板、简化项目结构

适用场景：

  • 博客系统、管理后台、CMS、企业内部 API
  • 原型验证期快速上线
  • 需要标准化 CRUD 的微服务架构

十一、结语

使用 FastCRUD 开发博客 API，可以让你在几分钟内完成整个后端骨架。 它让我们从繁琐的 CRUD 模板代码中解放出来，专注于业务逻辑与架构设计。

如果你想继续深入，可以考虑在 FastCRUD 基础上：

  • 加入用户权限体系（JWT / OAuth2）
  • 实现软删除、审计字段（created_at / updated_at）
  • 编写自定义查询（如"某用户的热门文章列表"）
相关推荐
程序员阿达3 小时前
开题报告之基于SpringBoot框架的图书借阅系统的设计与实现
java·spring boot·后端
Eoch773 小时前
吃透 Java 核心技术：JVM 调优、并发安全、微服务开发，解决 90% 企业级场景问题
java·后端
歪歪1003 小时前
详细介绍一下“集中同步+分布式入库”方案的具体实现步骤
开发语言·前端·分布式·后端·信息可视化
林太白3 小时前
rust17-部门管理模块
前端·后端·rust
C++chaofan3 小时前
MyBatis - Plus学习笔记
java·spring boot·笔记·后端·mysql·架构·mybatis
间彧3 小时前
如何设计异常分级策略，对不同级别异常（如业务异常、系统异常）采取不同的告警方式？
后端
间彧3 小时前
Micrometer详解与应用实战
后端
间彧3 小时前
SpringBoot/SpringCloud，如何实现监控埋点
后端
一缕南风3 小时前
Spring Boot 响应拦截器（Jackson）实现时间戳自动添加
java·spring boot·后端·拦截器
热门推荐
01GitHub 镜像站点02UV安装并设置国内源03综合整理：pdf预览显示：你尝试预览的文件可能对你的计算机有害。如果你信任此文件以及其来源，请打开此文件以看其内容，如何解决以正常预览文件04Linux下V2Ray安装配置指南05安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）06npm使用国内淘宝镜像的方法07《大数据技术原理与应用》实验报告三 熟悉HBase常用操作08BongoCat - 跨平台键盘猫动画工具09NVIDIA显卡驱动、CUDA、cuDNN 和 TensorRT 版本匹配指南10GitLab 零基础入门指南：从安装到项目管理全流程