FastAPI与Tortoise-ORM模型配置及aerich迁移工具

qcidyu

于 2025-04-30 00:32:19 发布

阅读量939

点赞数 32

分类专栏：文章归档文章标签： fastapi

本文链接：https://blog.csdn.net/qq_42210428/article/details/147622156

版权

title: FastAPI与Tortoise-ORM模型配置及aerich迁移工具
date: 2025/04/30 00:11:45
updated: 2025/04/30 00:11:45
author: cmdragon

excerpt:
FastAPI中使用Tortoise-ORM时，模型类通过继承tortoise.models.Model并定义class Meta来映射数据库字段。元数据配置包括表名、schema、表注释和联合唯一约束等。初始化数据库连接推荐使用lifespan事件处理，配置参数包括数据库URL、模型模块路径等。aerich迁移工具用于管理数据库迁移，通过init-db、migrate和upgrade等命令实现迁移文件的生成和应用。常见问题包括模型注册失败和迁移文件冲突，需检查模型路径和清除冲突文件。

categories:

后端开发
FastAPI

tags:

FastAPI
Tortoise-ORM
数据库迁移
aerich工具
模型元数据
数据库初始化
常见问题解决方案

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

探索数千个预构建的 AI 应用，开启你的下一个伟大创意：https://tools.cmdragon.cn/

第一章：模型类元数据配置基础

1.1 模型定义与元数据

在FastAPI中使用Tortoise-ORM时，模型类通过Python类属性与数据库字段建立映射关系。每个模型类必须继承自tortoise.models.Model
，并通过class Meta定义元数据：

from tortoise.models import Model
from tortoise import fields


class User(Model):
    id = fields.IntField(pk=True)
    username = fields.CharField(max_length=50, unique=True)
    created_at = fields.DatetimeField(auto_now_add=True)

    class Meta:
        table =