Kaip tvarkote klaidas ir iškylate HTTP išimtis?

Question

Accepted Answer

FastAPI tvarko klaidas **iškylydama išimtis**, kurias konvertuoja į tinkamas HTTP atsako. `HTTPException` padengia daugumą atvejų; pasirinktiniai išimčių tvarkikliai leidžia jums kontroliuoti klaidų formatavimą globaliai.

## HTTPException iškylimas

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

`raise HTTPException(status_code=..., detail=...)` yra idiomatinis būdas grąžinti klaidą — FastAPI sukuria JSON atsaką `{"detail": "..."}` su duotu statusu. `detail` gali būti bet kokia JSON-serializuojama reikšmė (eilutė, žodynas, sąrašas).

## Patvirtinimo klaidos yra automatinės (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.
```

## Pasirinktiniai išimčių tvarkikliai (globalus formatavimas)

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

Pasirinktiniai išimčių tvarkikliai leidžia jums susieti savo (domeno) išimtis su atsakais, centralizuoti klaidų formatavimą ir palikti tvarkiklio kodą švariu.

## Numatytųjų tvarkiklių perrašymas

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

## Kodėl tai svarbu

Tinkama klaidų tvarkymo sistema yra būtina kuriant patikimas, profesionalias API, o FastAPI metodas yra švaruS ir nuoseklus.

Idiomatinė `HTTPException` daro lengvą grąžinti teisingus klaidų atsakus su atitinkamais būsenos kodais ir pranešimais — pagrindiniai bet kuriam galiniam taškui, kuris gali nepavykti (nerasta, uždrausti, bloga būsena).

Tolygiai vertingas yra tai, kad **patvirtinimo klaidos tvarkosi automatiškai** (Pydantic nepavykimai sukuria struktūruotus 422 atsakus be jūsų kodo), ir kad **pasirinktiniai išimčių tvarkikliai** leidžia jums susieti savo domeno išimtis su atsakais ir priverstus nuoseklus klaidų formatą visoje API — pagerinant ir palaikymo patogumą (centralizuota klaidų logika), ir kliento patirtį (nuspėjamos klaidų formos).

Supratimas apie `HTTPException`, automatinius patvirtinimo klaidas ir pasirinktiniusTV tvarkiklius apima praktinį klaidų tvarkymo spektrą, todėl tai svarbi žinios kuriant patikimas API.