1. 为什么选择 FastAPI + SQLAlchemy 2.0 + MySQL 组合
如果你正在寻找一个高性能、易维护的后端数据服务解决方案,FastAPI 搭配 SQLAlchemy 2.0 和 MySQL 绝对值得考虑。这个组合在开发效率、运行性能和代码可维护性上都有出色表现。
FastAPI 是近年来最受欢迎的 Python Web 框架之一,它天生支持异步,性能接近 Node.js 和 Go。我在实际项目中使用后发现,它的自动文档生成和类型提示功能可以节省大量开发时间。而 SQLAlchemy 2.0 带来了全新的声明式 API 设计,代码更加简洁直观。MySQL 作为最流行的关系型数据库之一,稳定性无需多言。
这个技术栈特别适合以下场景:
- 需要快速开发但又不失性能的中大型项目
- 团队协作开发,需要良好的代码提示和文档支持
- 对数据一致性和事务处理有要求的应用
- 未来可能需要扩展为微服务架构的系统
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与基础配置
2.1 安装必要的依赖
在开始之前,确保你已经安装了 Python 3.7+ 环境。我推荐使用虚拟环境来管理依赖:
bash复制python -m venv venv
source venv/bin/activate # Linux/Mac
venv\Scripts\activate # Windows
然后安装核心依赖包:
bash复制pip install fastapi sqlalchemy pymysql pydantic
这里有几个值得注意的点:
pymysql是 Python 连接 MySQL 的驱动pydantic用于数据验证和序列化- 如果你需要异步支持,可以额外安装
aiomysql
2.2 数据库初始化
登录 MySQL 创建一个新数据库:
sql复制CREATE DATABASE fastapi_demo
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
我强烈建议使用 utf8mb4 字符集,因为它支持完整的 Unicode 字符,包括 emoji。在实际项目中,字符集问题导致的乱码很难排查,从一开始就使用正确的配置能避免很多麻烦。
3. 配置 SQLAlchemy 2.0 连接
3.1 数据库连接配置
创建一个 database.py 文件来管理数据库连接:
python复制from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker
from sqlalchemy.ext.declarative import declarative_base
SQLALCHEMY_DATABASE_URL = "mysql+pymysql://user:password@localhost/fastapi_demo?charset=utf8mb4"
engine = create_engine(
SQLALCHEMY_DATABASE_URL,
pool_pre_ping=True, # 自动检测连接是否有效
pool_size=5, # 连接池大小
max_overflow=10, # 超出pool_size后最多创建的连接数
pool_recycle=3600 # 连接回收时间(秒)
)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
Base = declarative_base()
这里有几个实用的配置参数:
pool_pre_ping: 自动检查连接是否有效,避免因连接超时导
