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

Question

IT Interview Practice · 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 بنانے کے لیے اہم علم بناتا ہے۔

HTTPException کو Raise کریں

Validation غلطیاں خودکار ہیں (422)

Custom exception handlers (global formatting)

Default handlers کو Override کریں

یہ کیوں اہم ہے

متعلقہ سوالات