Pydantic v2 thay đổi điều gì và tại sao nó quan trọng với FastAPI?

Question

Accepted Answer

**Pydantic v2** (một bản viết lại lớn với lõi ở **Rust**) mang lại những cải thiện hiệu năng lớn và thay đổi API. Vì Pydantic là trung tâm của FastAPI (validation, serialization, model), hiểu v2 quan trọng cho cả tốc độ lẫn viết code hiện đại đúng đắn.

## Điểm nổi bật: nhanh hơn nhiều (lõi Rust)

```text
Lõi validation của Pydantic v2 (pydantic-core) được viết bằng RUST → thường
nhanh hơn 5–50 lần về validation/serialization so với v1.
→ Vì FastAPI validate mọi request và serialize mọi response bằng Pydantic,
  điều này trực tiếp tăng tốc các app FastAPI.
```

Đây là thay đổi có tác động lớn nhất — validation nhanh hơn nghĩa là FastAPI nhanh hơn, không cần thay đổi code nào ngoài việc nâng cấp.

## Các thay đổi API then chốt (v1 → v2)

```python
# đổi tên method
model.dict()        → model.model_dump()          # sang một dict
model.json()        → model.model_dump_json()      # sang JSON
Model.parse_obj()   → Model.model_validate()        # từ một dict

# đổi tên decorator validator
@validator("field")      → @field_validator("field")    # + phải là một @classmethod
@root_validator         → @model_validator(mode="after")  # đa field

# config: một class Config → một dict model_config
class Config: ...        → model_config = ConfigDict(...)
```

Các method phổ biến và decorator validator đã được đổi tên — quan trọng khi đọc hoặc viết code, và khi migrate codebase v1.

## Hành vi nghiêm ngặt hơn, rõ ràng hơn

```text
✓ Ép kiểu nghiêm ngặt hơn theo mặc định (ít chuyển đổi ngầm gây ngạc nhiên hơn)
✓ Lỗi validation rõ ràng hơn, chi tiết hơn
✓ Hỗ trợ tốt hơn cho chế độ strict vs lax, computed field, kiểm soát serialization
✓ pydantic-settings được tách thành package riêng (BaseSettings chuyển sang đó)
```

## Tại sao điều này quan trọng với FastAPI cụ thể

```text
FastAPI dùng Pydantic cho: validate request body, serialize response_model,
validate query/path, settings, và OpenAPI schema. Vì vậy với Pydantic v2:
  ✓ tốc độ → xử lý request nhanh hơn trên toàn bộ
  ✓ thay đổi API → bạn phải dùng cú pháp v2 (model_dump, field_validator, v.v.)
  ✓ hành vi → validation nghiêm ngặt hơn, dự đoán được hơn
Các phiên bản FastAPI hiện đại yêu cầu/dùng Pydantic v2.
```

## Tại sao điều này quan trọng

Hiểu Pydantic v2 quan trọng với các lập trình viên FastAPI vì Pydantic là nền tảng của các tính năng cốt lõi của FastAPI (validation, serialization, model, settings, docs), nên thay đổi phiên bản lớn của nó trực tiếp ảnh hưởng cả hiệu năng lẫn cách bạn viết code.

Lợi ích nổi bật — một **lõi dựa trên Rust mang lại validation/serialization nhanh hơn 5–50 lần** — trực tiếp tăng tốc các ứng dụng FastAPI (vốn validate mọi request và serialize mọi response qua Pydantic), một chiến thắng hiệu năng đáng kể đạt được chỉ bằng việc dùng v2.

Cũng quan trọng tương đương là các **thay đổi API**: các method được đổi tên (`model_dump`/`model_validate`) và decorator validator (`field_validator`/`model_validator`) nghĩa là bạn phải dùng cú pháp hiện đại để viết code đúng, và nhận ra các thay đổi này thiết yếu khi đọc code hiện tại, viết code mới, hoặc migrate codebase v1 cũ (một tác vụ thực tế phổ biến).

Hành vi validation nghiêm ngặt hơn, rõ ràng hơn cũng khiến ứng dụng dự đoán được hơn.

Vì các phiên bản FastAPI hiện đại được xây trên Pydantic v2, biết điều gì thay đổi — các cải thiện hiệu năng, API mới, và các khác biệt hành vi — là kiến thức cấp senior quan trọng để làm việc hiệu quả với FastAPI hiện tại, tránh các pattern v1 lỗi thời, và hiểu tại sao FastAPI hoạt động như vậy.

Nó phản ánh nhận thức về nền tảng đang phát triển của framework và ngày càng liên quan khi hệ sinh thái chuẩn hóa trên v2.