Pydantic v2 有什么改变，为什么这对 FastAPI 很重要？

Question

Accepted Answer

**Pydantic v2**（使用 **Rust** 内核的重大改写）带来了显著的性能提升和 API 变更。由于 Pydantic 是 FastAPI 的核心（验证、序列化、模型），理解 v2 对性能和编写现代正确代码都很重要。

## 核心亮点：性能大幅提升（Rust 内核）

```text
Pydantic v2's validation core (pydantic-core) is written in RUST → typically
5–50x faster validation/serialization than v1.
→ Since FastAPI validates every request and serializes every response with Pydantic,
  this directly speeds up FastAPI apps.
```

这是最具影响力的变更——更快的验证意味着更快的 FastAPI，无需更改代码，只需升级。

## 关键 API 变更（v1 → v2）

```python
# method renames
model.dict()        → model.model_dump()          # to a dict
model.json()        → model.model_dump_json()      # to JSON
Model.parse_obj()   → Model.model_validate()        # from a dict

# validator decorators renamed
@validator("field")      → @field_validator("field")    # + must be a @classmethod
@root_validator         → @model_validator(mode="after")  # cross-field

# config: a class Config → model_config dict
class Config: ...        → model_config = ConfigDict(...)
```

常用方法和验证器装饰器被重命名——在阅读或编写代码时很重要，迁移 v1 代码库时也是如此。

## 更严格、更清晰的行为

```text
✓ Stricter type coercion by default (fewer surprising silent conversions)
✓ Clearer, more detailed validation errors
✓ Better support for strict vs lax modes, computed fields, serialization control
✓ pydantic-settings split into its own package (BaseSettings moved there)
```

## 为什么这对 FastAPI 特别重要

```text
FastAPI uses Pydantic for: request body validation, response_model serialization,
query/path validation, settings, and the OpenAPI schema. So Pydantic v2's:
  ✓ speed → faster request handling across the board
  ✓ API changes → you must use the v2 syntax (model_dump, field_validator, etc.)
  ✓ behavior → stricter, more predictable validation
Modern FastAPI versions require/use Pydantic v2.
```

## 为什么这很重要

FastAPI 开发者需要理解 Pydantic v2，因为 Pydantic 是 FastAPI 核心功能（验证、序列化、模型、设置、文档）的基础，所以其主版本变更直接影响性能和代码编写方式。

最大的收益——**基于 Rust 的内核可实现 5–50 倍的验证/序列化速度提升**——直接加快了 FastAPI 应用程序（通过 Pydantic 验证每个请求和序列化每个响应），这是升级到 v2 就能获得的显著性能收益。

同样重要的是 **API 变更**：重命名的方法（`model_dump`/`model_validate`）和验证器装饰器（`field_validator`/`model_validator`）意味着你必须使用现代语法编写正确的代码，识别这些变更对阅读当前代码、编写新代码或迁移旧的 v1 代码库（常见的现实任务）至关重要。

更严格、更清晰的验证行为也使应用程序更加可预测。

由于现代 FastAPI 版本基于 Pydantic v2，了解发生了什么变更——性能提升、新的 API 和行为差异——是高级开发者有效使用当前 FastAPI、避免过时 v1 模式和理解 FastAPI 性能表现原因的必备知识。

这体现了对框架不断演进基础的认识，随着生态系统逐步标准化采用 v2，其相关性也在不断提升。