Kako slučajete greške i bacate HTTP iznimke?

Question

Accepted Answer

FastAPI rukuje greškama **bacanjem iznimki** koje pretvara u odgovarajuće HTTP odgovore. `HTTPException` pokriva većinu slučajeva; prilagođeni rukovatelji iznimki vam omogućuju globalno kontroliranje oblikovanja grešaka.

## Bacanje HTTPException

```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=...)` je idiomatski način vraćanja greške — FastAPI proizvodi JSON odgovor `{"detail": "..."}` sa danim statusom. `detail` može biti bilo koja JSON-serijalizabilna vrijednost (niz, dict, lista).

## Greške validacije su automatske (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.
```

## Prilagođeni rukovatelji iznimki (globalno oblikovanje)

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

Prilagođeni rukovatelji iznimki vam omogućuju preslikavanje vlastitih (domenskih) iznimki na odgovore, centraliziranje oblikovanja grešaka i čuvanje kôda rukovalca čistim.

## Nadjačavanje zadanih rukovalaca

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

## Zašto je to važno

Odgovarajuće rukovanje greškama ključno je za gradnju pouzdanih, profesionalnih API-ja, a pristup FastAPI-ja je jasan i dosljedan.

Idiomatski `HTTPException` omogućava lako vraćanje ispravnih odgovora o greškama s odgovarajućim kodovima statusa i porukama — temeljno za bilo koju krajnju točku koja može neuspješiti (nije pronađena, zabranjena, loše stanje).

Jednako vrijedna je činjenica da su **greške validacije automatski obrađene** (Pydantic greške proizvode strukturirane 422 odgovore bez kôda s vaše strane), i da **prilagođeni rukovatelji iznimki** vam omogućuju preslikavanje vlastitih domenskih iznimki na odgovore i nametnuti dosljedan format grešaka na cijelom API-ju — poboljšavajući kako održivost (centralizirana logika grešaka) tako i doživljaj korisnika (predvidivi oblici grešaka).

Razumijevanje `HTTPException`, automatskih grešaka validacije i prilagođenih rukovalaca pokriva praktični spektar rukovanja greškama, čineći je važno znanje za gradnju robusnih API-ja.