### Flask SQLAlchemy BaseModel 继承与字段定义 在 Flask 中使用 SQLAlchemy 时，可以通过定义一个抽象基类 `BaseModel` 来实现模型的继承。此基类可以包含通用字段如 `id`、`created_at` 和 `updated_at` 等，从而减少代码重复并提高可维护性。 以下是一个完整的实现示例： ```python from datetime import datetime from flask_sqlalchemy import SQLAlchemy from sqlalchemy import Column, Integer, DateTime db = SQLAlchemy() class BaseModel(db.Model): """定义一个抽象基类 BaseModel""" __abstract__ = True # 声明当前类为抽象类，不会被创建为数据库表 [^1] id = Column(Integer, primary_key=True, autoincrement=True) # 主键字段 created_at = Column(DateTime, default=datetime.utcnow, nullable=False) # 创建时间字段 updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow, nullable=False) # 更新时间字段 def to_dict(self): """将对象转换为字典形式""" return {c.name: getattr(self, c.name) for c in self.__table__.columns} ``` 当其他模型需要继承这些通用字段时，只需让它们继承 `BaseModel` 即可。例如： ```python class User(BaseModel): """用户模型""" __tablename__ = 'user' name = Column(String(50), nullable=False) # 用户名 email = Column(String(120), unique=True, nullable=False) # 邮箱 password = Column(String(128), nullable=False) # 密码 def __repr__(self): return f"<User(name={self.name})>" ``` 在这个例子中，`User` 模型自动包含了 `id`、`created_at` 和 `updated_at` 字段[^2]。 --- ### 关于字段的功能说明 1. **`id` 字段** - 定义为主键，并设置 `autoincrement=True`，确保每次插入新记录时自动生成唯一值。 2. **`created_at` 字段** - 使用 `default=datetime.utcnow` 设置默认值为当前时间。 - `nullable=False` 表示该字段不能为空。 3. **`updated_at` 字段** - 同样使用 `default=datetime.utcnow` 设置默认值。 - 添加了 `onupdate=datetime.utcnow` 属性，确保每次更新记录时自动更新时间。 --- ### 数据库迁移支持 如果使用 Alembic 进行数据库迁移，可以按照以下方式添加字段： #### 升级迁移脚本 (`upgrade`) ```python def upgrade(): op.add_column('user', sa.Column('created_at', sa.DateTime, nullable=False, server_default=sa.text('CURRENT_TIMESTAMP'))) op.add_column('user', sa.Column('updated_at', sa.DateTime, nullable=False, server_default=sa.text('CURRENT_TIMESTAMP'), onupdate=sa.text('CURRENT_TIMESTAMP'))) ``` #### 降级迁移脚本 (`downgrade`) ```python def downgrade(): op.drop_column('user', 'updated_at') op.drop_column('user', 'created_at') ``` 通过上述方式，可以确保迁移脚本正确处理新增字段[^3]。 --- ### 注意事项 - 如果项目中需要支持多语言或更复杂的字段类型，可以参考 `sqlalchemy` 的文档扩展字段定义[^4]。 - 确保 `created_at` 和 `updated_at` 的默认值逻辑一致，避免因时区问题导致数据不一致。 ---