तपाईं त्रुटिहरू कसरी सम्भाल्नुहुन्छ र HTTP अपवादहरू कसरी उठाउनुहुन्छ?

Question

Accepted Answer

FastAPI ले अपवादहरू उठाएर त्रुटिहरू सम्भाल्छ जुन यसले उपयुक्त HTTP प्रतिक्रियामा रूपान्तरित गर्छ। `HTTPException` अधिकांश केसहरू कभर गर्छ; कस्टम अपवाद ह्यान्डलरहरूले तपाईंलाई त्रुटि ढाँचालाई विश्वव्यापी रूपमा नियन्त्रण गर्न दেय।

## 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=...)` त्रुटि फिर्ता गर्ने परम्परागत तरिका हो — FastAPI ले दिइएको स्थितिको साथ JSON प्रतिक्रिया `{"detail": "..."}` उत्पादन गर्छ। `detail` कुनै पनि JSON-serializableमान हुन सक्छ (स्ट्रिङ, dict, सूची)।

## सत्यापन त्रुटिहरू स्वचालित हुन् (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.
```

## कस्टम अपवाद ह्यान्डलरहरू (विश्वव्यापी ढाँचा)

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

कस्टम अपवाद ह्यान्डलरहरूले तपाईंलाई आफ्नो (डोमेन) अपवादहरूलाई प्रतिक्रियामा म्याप गर्न देय, त्रुटि ढाँचालाई केन्द्रीकृत गर्नु र ह्यान्डलर कोडलाई सफा राख्नु।

## पूर्वनिर्धारित ह्यान्डलरहरू अधिलेखन गर्नु

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

## किन यो महत्त्वपूर्ण छ

यथार्थ त्रुटि सम्भालन विश्वस्त, व्यावसायिक API हरू निर्माण गर्नको लागि आवश्यक छ, र FastAPI को दृष्टिकोण सफा र सुसंगत छ।

परम्परागत `HTTPException` ले सही त्रुटि प्रतिक्रियाहरू उपयुक्त स्थिति कोड र सन्देशहरू सहित फिर्ता गर्न सजिलो बनाउछ — कुनै पनि endpoint को लागि आधारभूत जुन विफल हुन सक्छ (फेला नपरेको, निषेधित, खराब अवस्था)।

समान रूपमा मूल्यवान यो छ कि **सत्यापन त्रुटिहरू स्वचालित रूपमा सम्भाल गरिन्छ** (Pydantic विफलताहरूले तपाईंबाट कुनै कोड बिना संरचित 422 प्रतिक्रियाहरू उत्पादन गर्छ), र **कस्टम अपवाद हन्डलरहरू** ले तपाईंलाई आफ्नो डोमेन अपवादहरूलाई प्रतिक्रियामा म्याप गर्न र सम्पूर्ण API भर एक सुसंगत त्रुटि ढाँचा लागू गर्न देय — रक्षणीयता (केन्द्रीकृत त्रुटि तर्क) र ग्राहक अनुभव (अनुमानित त्रुटि आकारहरू) दुवै सुधार गर्दै।

`HTTPException`, स्वचालित सत्यापन त्रुटिहरू, र कस्टम हन्डलरहरू बुझ्नु त्रुटि सम्भालनको व्यावहारिक स्पेक्ट्रम कभर गर्छ, यसलाई दुबै APIs निर्माण गर्नको लागि महत्त्वपूर्ण ज्ञान बनाउँछ।