如何利用Pydantic对FastAPI接收的Payload数据进行转换

针对你的需求，用Pydantic实现的话有两种更优的方案，比你提出的普通类方案更贴合FastAPI生态，还能保留Pydantic的类型安全、验证等特性：

方案一：在原始模型中添加计算属性（Pydantic v2+ 推荐） #

直接在Payload模型里用computed_field生成拆分后的属性，验证完成后就能直接访问，无需额外转换步骤：

from fastapi import FastAPI
from pydantic import BaseModel, validator, computed_field

class Payload(BaseModel):
    string_params: str  # 格式如 param1%param2%param3
    second_param: dict

    @validator("string_params")
    def validate_string_params(cls, value):
        parts = value.split("%")
        if len(parts) != 3:
            raise ValueError("string_params 必须包含3个用%分隔的子参数")
        return value

    @computed_field
    @property
    def param1(self) -> str:
        return self.string_params.split("%")[0]

    @computed_field
    @property
    def param2(self) -> str:
        return self.string_params.split("%")[1]

    @computed_field
    @property
    def param3(self) -> str:
        return self.string_params.split("%")[2]

app = FastAPI()

@app.post("/my_route")
async def post_my_route(payload: Payload):
    # 直接通过属性访问拆分后的参数
    print(payload.param1, payload.param2, payload.param3)
    func(payload)

这个方案最简洁，所有逻辑集中在一个模型里，Pydantic会自动处理类型提示，实例可以直接在任何场景复用，不需要额外创建类。

方案二：创建独立的转换后模型（适合复杂场景） #

如果拆分逻辑复杂，或者需要和原始请求模型分离，可以新建一个Pydantic模型，通过类方法从原始Payload初始化：

from fastapi import FastAPI
from pydantic import BaseModel, validator

# 原始请求模型，负责接收和验证输入
class RawPayload(BaseModel):
    string_params: str  # param1%param2%param3
    second_param: dict

    @validator("string_params")
    def validate_string_params(cls, value):
        parts = value.split("%")
        if len(parts) != 3:
            raise ValueError("string_params 必须包含3个用%分隔的子参数")
        return value

# 转换后的模型，用于业务逻辑复用
class TransformedPayload(BaseModel):
    param1: str
    param2: str
    param3: str
    second_param: dict

    @classmethod
    def from_raw(cls, raw_payload: RawPayload):
        param_parts = raw_payload.string_params.split("%")
        return cls(
            param1=param_parts[0],
            param2=param_parts[1],
            param3=param_parts[2],
            second_param=raw_payload.second_param
        )

app = FastAPI()

@app.post("/my_route")
async def post_my_route(payload: RawPayload):
    transformed = TransformedPayload.from_raw(payload)
    # 直接访问转换后的属性
    print(transformed.param1)
    func(transformed)

这个方案把输入验证和业务模型分离，TransformedPayload可以单独添加额外的验证规则，还支持序列化/反序列化，适合需要在多个业务场景复用转换后数据的情况。

对比你的原始思路 #

你提出的普通类方案虽然能实现转换，但缺少Pydantic自带的类型提示、自动验证、序列化等核心功能，也无法直接和FastAPI的请求处理流程无缝集成。用Pydantic模型的方案既能完成转换需求，又能保证数据的一致性和类型安全，复用性更强。

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