SQLAlchemy中如何给继承其他表模型的子模型设置字段默认值

• 运行环境技术栈：Postgres、Python、SQLAlchemy、FactoryBoy，当前用于自动化测试场景，测试执行失败
• 已定义两个ORM表模型：File、Letter，继承关系如下：
  1. Letter 继承自 File：class Letter(File):
  2. File 继承自SQLAlchemy的DeclarativeBase：class File(DeclarativeBase):
• 字段约束：File模型中定义了content_type字段，设置为非空（not nullable）

在Letter模型中将content_type字段的默认值固定为"application/pdf"，当前所有尝试的实现方案均不生效，创建Letter实例时会因content_type无值触发NotNullViolation错误，导致测试失败。

1. 在自定义基类File和子类Letter的__init__方法中通过kwargs尝试设置该字段值，未生效
2. 考虑在Letter模型中重复定义content_type字段，但该方案违反第三范式，不采用
3. 在FactoryBoy编写的测试用例中直接传入content_type值，未生效
4. 在FactoryBoy的LetterFactory中直接添加content_type = "application/pdf"配置，未生效
5. 在LetterFactory的Meta类中尝试给模型赋值，未生效，代码如下：

class Meta(SQLAlchemyOptions):
    model = Letter
    model.content_type = "application/pdf"

6. 在Letter模型中通过@property重写content_type属性返回固定值，未生效，代码如下：

@property
def content_type(self):
    return "application/pdf"

之前方案失效的核心原因有两个：一是SQLAlchemy的字段本身是优先级更高的数据描述符，普通property、类属性赋值会被字段描述符覆盖；二是修改__init__传参容易受继承链super调用顺序影响，参数被提前消费导致赋值失败。
按以下两步修改即可，不需要重复定义字段，完全符合第三范式：

1. 模型层添加默认值注入逻辑 #

用SQLAlchemy自带的事件监听机制，在Letter实例初始化时自动注入默认值，不改动基类字段定义，不会产生映射冲突：

from sqlalchemy import event

class Letter(File):
    # 按你原有的继承配置写，单表继承不需要声明__tablename__，类表继承填自己的表名即可
    __mapper_args__ = {
        "polymorphic_identity": "letter"
    }
    # 其他原有字段保持不变

# 监听Letter实例的初始化事件，实例化时未传content_type就自动注入默认值
@event.listens_for(Letter, "init")
def inject_letter_content_type_default(target, args, kwargs):
    if "content_type" not in kwargs:
        kwargs["content_type"] = "application/pdf"

这个方案不管是直接代码实例化Letter()，还是ORM做插入操作，都会自动带上默认值，从根源解决非空约束报错。

2. 修正FactoryBoy工厂配置 #

之前在工厂类里直接写字段没生效，是因为SQLAlchemy模型工厂的字段声明需要和模型字段映射对齐，正确写法如下：

import factory
from factory.alchemy import SQLAlchemyModelFactory

class LetterFactory(SQLAlchemyModelFactory):
    class Meta:
        model = Letter
        sqlalchemy_session = test_db_session  # 替换为你测试用的数据库会话实例
        sqlalchemy_session_persistence = "commit"

    # 显式声明字段默认值，和模型层配置形成双重保险
    content_type = "application/pdf"
    # 其余业务字段按原有逻辑补充即可

之前方案失效的原因说明 #

• 重写@property无效：SQLAlchemy的Column是数据描述符，实例属性访问优先级高于类上定义的普通property，ORM读写字段时不会走自定义的property方法
• Meta类里给model.content_type赋值无效：这个操作只是给工厂的Meta类绑定了属性，根本没有修改模型本身的字段逻辑，执行时不会生效
• __init__里塞kwargs无效：多继承场景下super()调用顺序不确定，很容易出现kwargs被上层基类提前消费，子类赋值逻辑根本不执行的问题，事件监听的方式不受继承链顺序影响
• 重复定义content_type列完全没必要：不仅会产生ORM字段映射冲突，也确实违反范式要求，用事件注入的方式完全可以达到效果

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