如何在Python中创建继承自TypeVar的泛型类？

AI 小北

2026-7-9

解决泛型类元类冲突问题

错误原因

你写的代码里把TypeVar直接作为父类，这是错误用法。TypeVar只是类型提示的占位符，不是可实例化的类，不能用来作为类的基类。同时Generic[T]有自己的元类，和不存在的T的元类（T不是类）冲突，就抛出了metaclass conflict错误。

针对FastAPI响应场景的正确实现

你的需求是让派生类拥有T的所有字段，用于FastAPI响应，结合FastAPI常用的Pydantic模型，有两种常见方案：

方案1：统一响应格式（封装T为字段）

这是FastAPI中最常用的统一响应模式，把业务数据（T）作为data字段，加上通用的响应状态码、消息等字段：

from typing import TypeVar, Generic
from pydantic import BaseModel

# 限制T必须是Pydantic模型
T = TypeVar("T", bound=BaseModel)

class ApiResponse(BaseModel, Generic[T]):
    code: int = 200
    message: str = "请求成功"
    data: T

# 定义业务模型
class User(BaseModel):
    id: int
    name: str

# 使用示例：ApiResponse[User]会包含User的所有字段在data中
# FastAPI中可以直接作为响应类型返回
@app.get("/user", response_model=ApiResponse[User])
def get_user():
    return {"data": {"id": 1, "name": "张三"}}

方案2：扩展T的字段（直接继承T的属性）

如果需要让新类直接拥有T的所有字段并添加额外字段，可以用带绑定的TypeVar，让泛型类继承自T：

from typing import TypeVar, Generic
from pydantic import BaseModel

T = TypeVar("T", bound=BaseModel)

class ExtendedModel(T, Generic[T]):
    extra_field: str = "默认值"

# 使用示例
class User(BaseModel):
    id: int
    name: str

# ExtendedUser会拥有id、name、extra_field三个字段
ExtendedUser = ExtendedModel[User]
instance = ExtendedUser(id=1, name="张三")
print(instance.dict())  # {'id': 1, 'name': '张三', 'extra_field': '默认值'}