使用 Aerich 进行 FastAPI 数据库迁移指南

Aerich 是专为 Tortoise ORM 设计的轻量级数据库迁移工具，特别适合 FastAPI 项目。以下是完整的 Aerich 使用指南：

1. 安装依赖

pip install aerich tortoise-orm

2. 初始化 Aerich：

在项目根目录执行：

aerich init -t app.core.tortoise_config.TORTOISE_ORM

这会创建：

• aerich.ini 配置文件

• migrations 目录（存放迁移脚本）
  
  

3. 配置 Tortoise ORM

基本迁移流程

1. 生成初始迁移

aerich init-db

• 这会创建数据库表（如果不存在）

• 生成初始迁移记录
  
  

2. 修改模型后生成迁移脚本

aerich migrate --name "add_user_table"

3. 应用迁移

aerich upgrade