使用requests发送Pydantic模型时Decimal与date类型序列化失败问题

问题根源在于：requests.post的json参数默认使用Python标准库的json模块进行序列化，不会自动触发Pydantic模型中定义的@field_serializer，导致Decimal、datetime.date这类非JSON原生类型无法被序列化。

以下是两种可行的解决方法：

方法1：使用Pydantic的model_dump_json()直接生成JSON字符串 #

直接利用Pydantic内置的序列化能力生成符合要求的JSON字符串，传给requests.post的data参数，并指定正确的请求头：

import requests
from pydantic import BaseModel, field_serializer
from datetime import date
from decimal import Decimal

class MyDataModel(BaseModel):
    name: str
    amount: Decimal
    event_date: date

    @field_serializer('amount')
    def serialize_amount(self, value: Decimal) -> str:
        return str(value)

    @field_serializer('event_date')
    def serialize_date(self, value: date) -> str:
        return value.isoformat()

# 实例化模型
data = MyDataModel(name="Test", amount=Decimal("100.50"), event_date=date.today())

# 发送请求
response = requests.post(
    "https://third-party-api.com/endpoint",
    data=data.model_dump_json(),
    headers={"Content-Type": "application/json"}
)

方法2：使用model_dump(mode='json')生成JSON兼容字典 #

通过model_dump(mode='json')让Pydantic自动应用序列化器，将模型转换为可被标准json模块序列化的字典，直接传给requests.post的json参数：

# 基于上面定义的MyDataModel和data实例
response = requests.post(
    "https://third-party-api.com/endpoint",
    json=data.model_dump(mode='json')
)

关键说明 #

• 如果你用的是Pydantic v1版本，对应替换为.json()（替代model_dump_json()）和.dict(mode='json')（替代model_dump(mode='json')）即可。
• 不要直接传递model_dump()（默认mode='python'）的结果给json参数，此时字典中仍保留Decimal、date这类原生对象，会触发序列化异常。

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