Pydantic v2 มีอะไรเปลี่ยนแปลงไป และทำไมจึงสำคัญต่อ FastAPI?

Question

Accepted Answer

**Pydantic v2** (การเขียนใหม่ครั้งใหญ่โดยมี core เป็น **Rust**) นำมาซึ่งการเพิ่มประสิทธิภาพอย่างมากและการเปลี่ยนแปลง API เนื่องจาก Pydantic เป็นหัวใจสำคัญของ FastAPI (การ validation, serialization, model) การเข้าใจ v2 จึงสำคัญทั้งในด้านความเร็วและการเขียนโค้ดสมัยใหม่ที่ถูกต้อง

## หัวข้อหลัก: เร็วขึ้นมาก (Rust core)

```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.
```

นี่คือการเปลี่ยนแปลงที่ส่งผลกระทบมากที่สุด — การ validate ที่เร็วขึ้นหมายถึง FastAPI ที่เร็วขึ้น โดยไม่ต้องเปลี่ยนโค้ดใดนอกจากการ upgrade

## การเปลี่ยนแปลง 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(...)
```

Method ทั่วไปและ validator decorator ถูกเปลี่ยนชื่อ — สำคัญเมื่ออ่านหรือเขียนโค้ด และเมื่อ migrate codebase ที่เป็น 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.
```

## ทำไมจึงสำคัญ

การเข้าใจ Pydantic v2 สำคัญสำหรับนักพัฒนา FastAPI เพราะ Pydantic เป็นรากฐานของฟีเจอร์หลักของ FastAPI (การ validation, serialization, model, settings, docs) ดังนั้นการเปลี่ยน major version ของมันจึงส่งผลโดยตรงทั้งต่อประสิทธิภาพและวิธีที่คุณเขียนโค้ด

ประโยชน์หลัก — **core ที่อิงกับ Rust ที่ให้การ validation/serialization เร็วขึ้น 5–50 เท่า** — เพิ่มความเร็วให้แอปพลิเคชัน FastAPI โดยตรง (ซึ่ง validate ทุก request และ serialize ทุก response ผ่าน Pydantic) เป็นการได้เปรียบด้านประสิทธิภาพอย่างมีนัยสำคัญเพียงแค่อยู่บน v2

ที่สำคัญพอ ๆ กันคือ **การเปลี่ยนแปลง API**: method ที่เปลี่ยนชื่อ (`model_dump`/`model_validate`) และ validator decorator (`field_validator`/`model_validator`) หมายความว่าคุณต้องใช้ syntax สมัยใหม่จึงจะเขียนโค้ดได้ถูกต้อง และการรู้จักการเปลี่ยนแปลงเหล่านี้เป็นสิ่งจำเป็นเมื่ออ่านโค้ดปัจจุบัน, เขียนโค้ดใหม่ หรือ migrate codebase v1 เก่า (งานที่พบบ่อยในโลกจริง)

พฤติกรรมการ validate ที่เข้มงวดและชัดเจนขึ้นยังทำให้แอปพลิเคชันคาดเดาได้มากขึ้น

เนื่องจาก FastAPI เวอร์ชันสมัยใหม่ถูกสร้างบน Pydantic v2 การรู้ว่ามีอะไรเปลี่ยนไป — การเพิ่มประสิทธิภาพ, API ใหม่ และความแตกต่างด้านพฤติกรรม — เป็นความรู้ระดับ senior ที่สำคัญสำหรับการทำงานกับ FastAPI ปัจจุบันได้อย่างมีประสิทธิภาพ, หลีกเลี่ยงรูปแบบ v1 ที่ล้าสมัย และเข้าใจว่าทำไม FastAPI จึงมีประสิทธิภาพเช่นนั้น

มันสะท้อนถึงความตระหนักในรากฐานที่กำลังพัฒนาของ framework และมีความเกี่ยวข้องมากขึ้นเรื่อย ๆ เมื่อ ecosystem เริ่มมาตรฐานบน v2