Hogyan kezelitek a hibákat és dobsz ki HTTP kivételeket?

Question

Accepted Answer

A FastAPI **kivételek dobásával** kezeli a hibákat, amelyeket megfelelő HTTP válaszokra konvertál. A `HTTPException` a legtöbb esetet lefedi; az egyéni kivételkezelők lehetővé teszik a hibák formázásának globális vezérlését.

## HTTPException dobása

```python
from fastapi import HTTPException

@app.get("/items/{id}")
def get_item(id: int):
    item = db.get(id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found")   # → 404 JSON response
    if not item.is_public:
        raise HTTPException(status_code=403, detail="Forbidden")
    return item
```

A `raise HTTPException(status_code=..., detail=...)` az idiomatikus módja a hiba visszaadásának — a FastAPI egy `{"detail": "..."}` JSON választ állít elő az adott státusszal. A `detail` bármilyen JSON-szerializálható érték lehet (string, dict, lista).

## Az érvényesítési hibák automatikusak (422)

```text
When request data fails Pydantic validation, FastAPI AUTOMATICALLY returns a 422
with a structured list of exactly which fields are wrong — you write nothing.
```

## Egyéni kivételkezelők (globális formázás)

```python
from fastapi import Request
from fastapi.responses import JSONResponse

class ItemNotFound(Exception):
    def __init__(self, item_id: int): self.item_id = item_id

@app.exception_handler(ItemNotFound)         # handle a custom exception type globally
def handle_not_found(request: Request, exc: ItemNotFound):
    return JSONResponse(status_code=404, content={"error": f"Item {exc.item_id} not found"})

@app.get("/items/{id}")
def get(id: int):
    raise ItemNotFound(id)        # raise your domain exception; the handler formats it
```

Az egyéni kivételkezelők lehetővé teszik a saját (domain) kivételek válaszokra való leképezését, központosítják a hibaformázást és a kezelőkód tisztán tartják.

## Az alapértelmezett kezelők felülírása

```python
from fastapi.exceptions import RequestValidationError

@app.exception_handler(RequestValidationError)   # customize the 422 validation-error format
def validation_handler(request, exc):
    return JSONResponse(status_code=422, content={"errors": exc.errors()})
```

## Miért fontos

A megfelelő hibakezelés elengedhetetlen a megbízható, professzionális API-k felépítéséhez, és a FastAPI megközelítése tiszta és konzisztens.

Az idiomatikus `HTTPException` könnyűvé teszi a helyes hibaválaszok visszaadását megfelelő státuszkódokkal és üzenetekkel — alapvető minden olyan végponthoz, amely meghiúsulhat (nem található, tiltott, rossz állapot).

Egyformán értékes, hogy az **érvényesítési hibákat automatikusan kezeli** (a Pydantic hibái az Ön részéről kód nélkül strukturált 422 válaszokat hoznak létre), és hogy az **egyéni kivételkezelők** lehetővé teszik a saját domain kivételek válaszokra való leképezését és egy konzisztens hibaformátum érvényesítését a teljes API-n — amely javítja az karbantarthatóságot (központosított hibalogiká) és az ügyfélélményt (előrejelezhető hibaformák).

A `HTTPException`, az automatikus érvényesítési hibák és az egyéni kezelők megértése a hibakezelés gyakorlati spektrumát fedi le, így fontos tudás a robusztus API-k felépítéséhez.