FastAPI与SQLAlchemy数据库集成与CRUD操作

title: FastAPI与SQLAlchemy数据库集成与CRUD操作
date: 2025/04/16 09:50:57
updated: 2025/04/16 09:50:57
author: cmdragon

excerpt:
FastAPI与SQLAlchemy集成基础包括环境准备、数据库连接配置和模型定义。CRUD操作通过数据访问层封装和路由层实现，确保线程安全和事务管理。常见错误如422请求验证错误通过Pydantic模型和中间件处理。Session生命周期管理依赖注入系统保证每个请求独立会话。常见报错如数据库连接失败和事务回滚通过检查服务状态、验证连接参数和异常处理解决。

categories:

后端开发
FastAPI

tags:

FastAPI
SQLAlchemy
数据库集成
CRUD操作
Session管理
错误处理
MySQL

扫描二维码关注或者微信搜一搜：编程智域前端至全栈交流与成长

探索数千个预构建的 AI 应用，开启你的下一个伟大创意

1. FastAPI 与 SQLAlchemy 同步数据库集成基础

1.1 环境准备与安装

首先创建虚拟环境并安装必要依赖：

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate.bat  # Windows
pip install fastapi uvicorn sqlalchemy pymysql

1.2 数据库连接配置

在database.py中配置核心数据库连接：

from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmakerSQLALCHEMY_DATABASE_URL = "mysql+pymysql://user:password@localhost/mydatabase"
engine = create_engine(SQLALCHEMY_DATABASE_URL,pool_size=20,max_overflow=0,pool_pre_ping=True
)SessionLocal = sessionmaker(autocommit=False,autoflush=False,bind=engine,expire_on_commit=False
)

1.3 模型定义与关系映射

在models.py中定义数据模型：

from sqlalchemy import Column, Integer, String
from database import Baseclass User(Base):__tablename__ = "users"id = Column(Integer, primary_key=True, index=True)name = Column(String(50), nullable=False)email = Column(String(100), unique=True)age = Column(Integer, default=18)def __repr__(self):return f"<User(name='{self.name}', email='{