为何Pydantic提示字段缺失？邮件通知API模型优化咨询

问题1：为何Pydantic提示字段缺失？ #

因为EmailNotificationSystem继承自EmailNotification，这意味着它必须包含EmailNotification（以及父类Notification）的所有必填字段：notification、priority、notification_from、email_to。但你实例化EmailNotificationSystem时，只传入了email参数，没有提供这些继承来的必填字段，Pydantic的校验机制会判定这些字段缺失，因此抛出错误。

另外还有个隐藏问题：你给ts字段设置的默认值是datetime.datetime.now(datetime.UTC).isoformat()，这会返回字符串，但字段类型定义的是datetime.datetime，类型不匹配，后续也会引发错误。

问题2：更优实践 #

方案1：拆分输入/输出模型（推荐） #

不要用继承叠加字段，分别定义输入模型和输出模型，输出模型包含输入模型的所有字段，再加上自动生成的id和ts：

from datetime import datetime, UTC
import uuid
from enum import Enum
from pydantic import BaseModel
from fastapi import FastAPI

app = FastAPI()

class NotificationPriority(Enum):
    high = "high"
    medium = "medium"
    low = "low"

# 输入模型：接收用户提交的参数
class EmailNotificationInput(BaseModel):
    notification: str
    priority: NotificationPriority
    notification_from: str
    email_to: str
    email_from: str | None = None

# 输出模型：返回给用户的结构，包含自动生成的ID和时间戳
class EmailNotificationOutput(BaseModel):
    notification: str
    priority: NotificationPriority
    notification_from: str
    email_to: str
    email_from: str | None = None
    id: uuid.UUID
    ts: datetime

@app.post("/notifications/email", response_model=EmailNotificationOutput)
async def create_notification(email_notification: EmailNotificationInput):
    return EmailNotificationOutput(
        **email_notification.model_dump(),
        id=uuid.uuid4(),
        ts=datetime.now(UTC)
    )

这种方式逻辑清晰，输入输出职责明确，彻底避免继承带来的字段校验问题。

方案2：继承输入模型+动态默认值 #

如果想复用输入模型的字段，可以让输出模型继承输入模型，用default_factory动态生成id和ts的默认值（避免类定义时固定值导致所有实例共用同一个ID/时间戳）：

from pydantic import BaseModel, Field

# 输入模型同方案1
class EmailNotificationOutput(EmailNotificationInput):
    id: uuid.UUID = Field(default_factory=uuid.uuid4)
    ts: datetime = Field(default_factory=lambda: datetime.now(UTC))

@app.post("/notifications/email", response_model=EmailNotificationOutput)
async def create_notification(email_notification: EmailNotificationInput):
    return EmailNotificationOutput(**email_notification.model_dump())

通过**email_notification.model_dump()把输入的所有字段展开传递给输出模型，无需手动逐个传参。

方案3：组合而非继承 #

如果需要保留原始输入结构并附加元数据，可以用组合方式，避免继承带来的必填字段约束：

class EmailNotificationSystem(BaseModel):
    email: EmailNotificationInput
    id: uuid.UUID = Field(default_factory=uuid.uuid4)
    ts: datetime = Field(default_factory=lambda: datetime.now(UTC))

@app.post("/notifications/email")
async def create_notification(email_notification: EmailNotificationInput):
    return EmailNotificationSystem(email=email_notification)

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