आप त्रुटियों को कैसे संभालते हैं और 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-क्रमांकन योग्य मान हो सकता है (स्ट्रिंग, 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()})
```

## यह क्यों मायने रखता है

विश्वसनीय, व्यावसायिक APIs बनाने के लिए उचित त्रुटि संभालना आवश्यक है, और FastAPI का दृष्टिकोण स्वच्छ और सुसंगत है।

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

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

`HTTPException`, स्वचालित सत्यापन त्रुटियां, और कस्टम हैंडलर को समझना त्रुटि संभालने के व्यावहारिक स्पेक्ट्रम को कवर करता है, जिससे यह मजबूत APIs बनाने के लिए महत्वपूर्ण ज्ञान बन जाता है।