如何为本地Tortoise+FastAPI项目创建并应用数据库迁移？

前提 #

确保已安装Aerich：

pip install aerich

1. 关联Tortoise配置（解决-t参数困惑） #

-t参数用于指定Tortoise ORM配置对象的完整模块路径，格式为[模块路径]:[配置变量名]。根据你的项目结构调整：

• 若Tortoise配置（如TORTOISE_ORM变量）在lom/app.py中，执行：

aerich init -t lom.app.TORTOISE_ORM --location migrations

• 若配置在lom/config.py中，替换为：

aerich init -t lom.config.TORTOISE_ORM --location migrations

--location migrations指定迁移文件存放目录，和你现有migrations目录对应，确保Aerich能读取已有迁移文件。

2. 初始化数据库连接 #

执行命令让Aerich同步数据库配置（会自动读取你TORTOISE_ORM里的URL，也可手动在生成的pyproject.toml/aerich.ini中确认URL为postgres://lom:lom@localhost:5432/lom）：

aerich init-db

3. 应用现有迁移 #

将migrations目录中已有的SQL迁移文件同步到本地PostgreSQL：

aerich upgrade

4. 创建新迁移（模型变更后） #

当修改Tortoise模型（新增表、字段等）后，生成新的迁移文件：

aerich migrate --name <迁移标识名>

替换<迁移标识名>为有意义的名称（如add_user_phone_field），新文件会自动生成在migrations目录。

内容的提问来源于stack exchange，提问作者mascai