আপনি কীভাবে ত্রুটিগুলি পরিচালনা করেন এবং 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-ক্রমানুবর্তনযোগ্য মান হতে পারে (স্ট্রিং, ডিক্ট, তালিকা)।

## যাচাইকরণ ত্রুটি স্বয়ংক্রিয় (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` সঠিক ত্রুটি প্রতিক্রিয়া ফেরত দেওয়া সহজ করে তোলে উপযুক্ত স্ট্যাটাস কোড এবং বার্তা সহ — যেকোনো এন্ডপয়েন্টের জন্য মৌলিক যা ব্যর্থ হতে পারে (পাওয়া যায় না, নিষিদ্ধ, খারাপ অবস্থা)।

সমান মূল্যবান যে **যাচাইকরণ ত্রুটি স্বয়ংক্রিয়ভাবে পরিচালিত হয়** (Pydantic ব্যর্থতা আপনার থেকে কোনো কোড ছাড়াই কাঠামোগত 422 প্রতিক্রিয়া তৈরি করে), এবং যে **কাস্টম ব্যতিক্রম হ্যান্ডলার** আপনাকে আপনার নিজস্ব ডোমেইন ব্যতিক্রমগুলি প্রতিক্রিয়ায় ম্যাপ করতে এবং পুরো API জুড়ে একটি সামঞ্জস্যপূর্ণ ত্রুটি ফর্ম্যাট প্রয়োগ করতে দেয় — রক্ষণাবেক্ষণযোগ্যতা (কেন্দ্রীয় ত্রুটি যুক্তি) এবং ক্লায়েন্ট অভিজ্ঞতা (অনুমানযোগ্য ত্রুটি আকৃতি) উভয়ই উন্নত করে।

`HTTPException`, স্বয়ংক্রিয় যাচাইকরণ ত্রুটি এবং কাস্টম হ্যান্ডলার বোঝা ত্রুটি পরিচালনার ব্যবহারিক বর্ণালী কভার করে, এটিকে শক্তিশালী API তৈরির জন্য গুরুত্বপূর্ণ জ্ঞান করে তোলে।