为何Pydantic会接受空字符串作为UUID类型值？

核心原因 #

这种情况主要和Pydantic的宽松类型转换策略以及字段的可选性配置有关，分两种最常见的场景：

1. 字段被标记为可选类型 #

如果你的字段定义是Optional[UUID] = None（或Python 3.10+的UUID | None = None），Pydantic v1（FastAPI默认配套版本）会将传入的空字符串自动转换为None——而可选类型允许None值，因此会直接通过校验。

示例代码：

from pydantic import BaseModel
from uuid import UUID
from typing import Optional

class Item(BaseModel):
    id: Optional[UUID] = None

# 空字符串会被转为None，顺利通过校验
item = Item(id="")
print(item.id)  # 输出: None

2. 严格校验模式未开启（Pydantic默认行为） #

如果字段是必填的id: UUID，正常情况下空字符串会因为无法解析为UUID而触发ValidationError。但如果你的项目保留了Pydantic v1的默认非严格模式，且存在自定义字段逻辑或特殊环境配置，可能出现异常通过的情况——不过这种场景极少，绝大多数情况还是字段的可选性配置导致的。

解决方案 #

若要禁止空字符串通过UUID字段校验，可通过以下两种方式处理：

1. 开启严格校验模式 #

通过模型的Config类开启严格模式，强制要求输入必须严格匹配UUID类型，禁止隐式转换：

from pydantic import BaseModel
from uuid import UUID

class Item(BaseModel):
    id: UUID

    class Config:
        strict = True

# 传入空字符串会直接抛出ValidationError
Item(id="")

2. 明确字段必填并禁用空值 #

使用Field工具明确标记字段为必填，同时确保只有合法的UUID字符串能通过校验：

from pydantic import BaseModel, Field
from uuid import UUID

class Item(BaseModel):
    id: UUID = Field(..., description="必须为有效的UUID格式字符串，不允许空值")

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