Co się zmieniło w Pydantic v2 i dlaczego to ma znaczenie dla FastAPI?

Question

Accepted Answer

**Pydantic v2** (duży rewrite z rdzeniem napisanym w **Rust**) przyniósł znaczące wzrosty wydajności i zmiany w API. Ponieważ Pydantic jest centralny dla FastAPI (walidacja, serializacja, modele), zrozumienie v2 ma znaczenie zarówno dla szybkości, jak i poprawnego pisania nowoczesnego kodu.

## Główny punkt: znacznie szybsze (rdzeń w 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.
```

To jest najistotniejsza zmiana — szybsza walidacja oznacza szybsze FastAPI, bez potrzeby zmian kodu poza aktualizacją.

## Kluczowe zmiany w 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(...)
```

Wspólne metody i dekoratory walidatorów zostały przemianowane — ważne przy czytaniu lub pisaniu kodu, a także przy migracji starszych codebase'ów v1.

## Bardziej rygorystyczne, jaśniejsze zachowanie

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

## Dlaczego to ważne dla 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.
```

## Dlaczego to ważne

Zrozumienie Pydantic v2 jest ważne dla programistów FastAPI, ponieważ Pydantic stanowi fundament kluczowych funkcji FastAPI (walidacja, serializacja, modele, ustawienia, dokumentacja), więc jego zmiana wersji major bezpośrednio wpływa zarówno na wydajność, jak i na sposób pisania kodu.

Główna korzyść — **rdzeń oparty na Rust dający 5–50-krotnie szybszą walidację/serializację** — bezpośrednio przyspieszają aplikacje FastAPI (które walidują każde żądanie i serializują każdą odpowiedź przez Pydantic), co jest znaczącym wygaśnięciem wydajności osiąganym już poprzez przejście na v2.

Równie ważne są **zmiany w API**: przemianowane metody (`model_dump`/`model_validate`) i dekoratory walidatorów (`field_validator`/`model_validator`) oznaczają, że musisz używać nowoczesnej składni do pisania poprawnego kodu, a rozpoznanie tych zmian jest niezbędne przy czytaniu aktualnego kodu, pisaniu nowego kodu lub migracji starszych codebase'ów v1 (zadanie częste w realnym świecie).

Bardziej rygorystyczne, jaśniejsze zachowanie walidacji czyni aplikacje bardziej przewidywalnymi.

Ponieważ nowoczesne wersje FastAPI są zbudowane na Pydantic v2, wiedza o tym, co się zmieniło — wzrosty wydajności, nowe API i różnice w zachowaniu — jest ważną wiedzą na poziomie senior do efektywnej pracy z aktualnym FastAPI, unikania przestarzałych wzorców v1 i zrozumienia, dlaczego FastAPI funkcjonuje tak, jak funkcjonuje.

Od tego uzależnia się świadomość ewoluującego fundamentu frameworka i jest coraz bardziej istotne, gdy ekosystem standaryzuje się wokół v2.