آپ غلطیوں کو کیسے ہینڈل کرتے ہیں اور HTTP exceptions کو کیسے raise کرتے ہیں؟

Question

Accepted Answer

FastAPI غلطیوں کو **exceptions raise** کرکے ہینڈل کرتا ہے جو انہیں مناسب HTTP responses میں تبدیل کرتا ہے۔ `HTTPException` زیادہ تر معاملات کو کور کرتا ہے؛ custom exception handlers آپ کو globally غلطی کی formatting کو کنٹرول کرنے دیتے ہیں۔

## HTTPException کو Raise کریں

```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=...)` غلطی واپس کرنے کا idiomatic طریقہ ہے — FastAPI ایک JSON response `{"detail": "..."}` دیے گئے status کے ساتھ تیار کرتا ہے۔ `detail` کوئی بھی JSON-serializable قدر ہو سکتی ہے (string، dict، list)۔

## Validation غلطیاں خودکار ہیں (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.
```

## Custom exception handlers (global formatting)

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

Custom exception handlers آپ کو اپنی (domain) exceptions کو responses میں map کرنے دیتے ہیں، غلطی کی formatting کو centralize کرتے ہیں اور handler code کو صاف رکھتے ہیں۔

## Default handlers کو Override کریں

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

## یہ کیوں اہم ہے

مناسب error handling قابل اعتماد، پیشہ ور APIs بنانے کے لیے ضروری ہے، اور FastAPI کا نقطہ نظر صاف اور مستقل ہے۔

Idiomatic `HTTPException` صحیح غلطی کے جوابات موزوں status codes اور messages کے ساتھ واپس کرنا آسان بناتا ہے — کسی بھی endpoint کے لیے بنیادی جو ناکام ہو سکتا ہے (نہ ملا، منع، بُرا state)۔

برابر قیمتی یہ ہے کہ **validation غلطیاں خودکار طور پر ہینڈل ہوتی ہیں** (Pydantic کی ناکامیاں آپ کی طرف سے کوئی code کے بغیر structured 422 responses تیار کرتی ہیں)، اور یہ کہ **custom exception handlers** آپ کو اپنی domain exceptions کو responses میں map کرنے اور پورے API میں مستقل غلطی کی format کو enforce کرنے دیتے ہیں — maintainability (centralized error logic) اور client کا تجربہ (predictable error shapes) دونوں بہتر بناتے ہیں۔

`HTTPException`، خودکار validation غلطیوں، اور custom handlers کو سمجھنا error handling کے عملی spectrum کو کور کرتا ہے، جو مضبوط APIs بنانے کے لیے اہم علم بناتا ہے۔