FastAPI zpracovává chyby vyvoláváním výjimek, které převádí na příslušné HTTP odpovědi. HTTPException pokrývá majority případů; vlastní obslužné programy výjimek vám umožňují globálně řídit formátování chyb.
fastapi HTTPException
():
item = db.get()
item:
HTTPException(status_code=, detail=)
item.is_public:
HTTPException(status_code=, detail=)
item
raise HTTPException(status_code=..., detail=...) je idiomatický způsob, jak vrátit chybu — FastAPI vytvoří JSON odpověď {"detail": "..."} s daným stavem. detail může být jakákoliv hodnota serializovatelná do JSON (řetězec, slovník, seznam).
When request data fails Pydantic validation, FastAPI AUTOMATICALLY returns a 422
with a structured list of exactly which fields are wrong — you write nothing.
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
Vlastní obslužné programy výjimek vám umožňují mapovat vaše vlastní (doménové) výjimky na odpovědi, centralizovat formátování chyb a udržovat kód obslužného programu čistý.
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()})
Správné zpracování chyb je nezbytné pro vytváření spolehlivých a profesionálních API, a přístup FastAPI je čistý a konzistentní.
Idiomatická HTTPException usnadňuje vrácení správných chybových odpovědí s vhodnými stavovými kódy a zprávami — základem pro jakýkoliv koncový bod, který může selhat (nenalezen, zakázán, špatný stav).
Rovněž cenné je, že chyby ověřování jsou zpracovávány automaticky (selhání Pydantic vytváří strukturované odpovědi 422 bez vašeho kódu), a že vlastní obslužné programy výjimek vám umožňují mapovat vaše vlastní doménové výjimky na odpovědi a vynucovat konzistentní formát chyb v celém API — zlepšuje údržbu (centralizovaná logika chyb) i zkušenost klienta (předvídatelné tvary chyb).
Porozumění HTTPException, automatickým chybám ověřování a vlastním obslužným programům výjimek pokrývá praktické spektrum zpracování chyb, což jej činí důležitou znalostí pro vytváření robustních API.