Kako rokovati z napakami in izničeti HTTP izjeme?

Question

Accepted Answer

FastAPI rokovati z napakami z **izbacovanjem izjem**, ki jih pretvori v ustrezne HTTP odgovore. `HTTPException` pokriva večino primerov; prilagojeni obdelovalci izjem omogočajo nadzor oblikovanja napak na globalni ravni.

## Izbacovanje 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 za vrnitev napake — FastAPI ustvari JSON odgovor `{"detail": "..."}` z danim stanjem. `detail` je lahko katera koli JSON-serialibilna vrednost (niz, slovar, seznam).

## Napake pri validaciji so samodejne (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.
```

## Prilagojeni obdelovalci izjem (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
```

Prilagojeni obdelovalci izjem omogočajo preslikavo vaših lastnih (domenskih) izjem v odgovore, centraliziranje oblikovanja napak in čistost kode obdelovalca.

## Prepisovanje privzetih obdelovalcev

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

## Zakaj je to pomembno

Ustrezna obdelava napak je bistvena za gradnjo zanesljivih, profesionalnih API-jev, in pristop FastAPI je čist in dosleden.

Idiomatski `HTTPException` olajšuje vrnitev pravilnih odgovorov o napakah s primerno statuso in sporočili — temeljni za vsak končni točko, ki se lahko ne uspe (ni najdeno, prepovedano, slabo stanje).

Enako dragoceno je, da se **napake pri validaciji rokovati samodejno** (neuspehi Pydantika ustvarijo strukturirane odgovore 422 brez vaše kode) in da **prilagojeni obdelovalci izjem** omogočajo preslikavo vaših lastnih domenskih izjem v odgovore in uveljavljanje dosledne oblike napak v celotnem API-ju — izboljšava tako vzdrževalnosti (centralizirana logika napak) kot izkušnje odjemalca (predvidljive oblike napak).

Razumevanje `HTTPException`, samodejnih napak pri validaciji in prilagojenih obdelovalcev pokriva praktični spekter obdelave napak, kar jo naredi pomembno znanje za gradnjo trdnih API-jev.