Hataları nasıl ele alırsınız ve HTTP istisnaları nasıl yükseltirsiniz?

Question

Accepted Answer

FastAPI, hataları **istisna yükselterek** ele alır ve bunları uygun HTTP yanıtlarına dönüştürür. `HTTPException` çoğu durumu kapsar; özel istisna işleyicileri hata biçimlendirmesini genel olarak kontrol etmenize olanak tanır.

## HTTPException Yükseltme

```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=...)` bir hata döndürmenin dilbilimsel yoludur — FastAPI verilen durum koduyla `{"detail": "..."}` şeklinde bir JSON yanıtı üretir. `detail` herhangi bir JSON-serileştirilebilir değer (string, dict, list) olabilir.

## Doğrulama hataları otomatiktir (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.
```

## Özel istisna işleyicileri (genel biçimlendirme)

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

Özel istisna işleyicileri kendi (domain) istisnalarınızı yanıtlarla eşleştirmenize, hata biçimlendirmesini merkezileştirmenize ve işleyici kodunu temiz tutmanıza olanak tanır.

## Varsayılan işleyicileri geçersiz kılma

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

## Neden önemli

Uygun hata işleme, güvenilir ve profesyonel API'ler oluşturmak için gereklidir ve FastAPI'nin yaklaşımı temiz ve tutarlıdır.

Dilbilimsel `HTTPException` uygun durum kodları ve mesajlarla doğru hata yanıtları döndürmeyi kolay hale getirir — başarısız olabilecek herhangi bir endpoint için temel (bulunmuyor, yasak, kötü durum).

Eşit derecede değerli olan, **doğrulama hatalarının otomatik olarak işlenmesi** (Pydantic hataları sizden kod girmeden yapılandırılmış 422 yanıtları üretir) ve **özel istisna işleyicileri** kendi domain istisnalarınızı yanıtlarla eşleştirmenize ve tüm API'de tutarlı bir hata biçimi uygulamanıza olanak tanımasıdır — hem bakımlanabilirliği (merkezi hata mantığı) hem de istemci deneyimini (öngörülebilir hata şekilleri) iyileştirir.

`HTTPException`, otomatik doğrulama hataları ve özel işleyicileri anlamak, hata işlemenin pratik yelpazesini kapsar, bu da güçlü API'ler oluşturmak için önemli bilgi yapar.