Πώς χειρίζεστε σφάλματα και ρίχνετε εξαιρέσεις 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()})
```

## Γιατί είναι σημαντικό

Η σωστή διαχείριση σφαλμάτων είναι απαραίτητη για τη δημιουργία αξιόπιστων, επαγγελματικών API και η προσέγγιση του FastAPI είναι καθαρή και συνεπής.

Το ιδιωματικό `HTTPException` διευκολύνει την επιστροφή σωστών απαντήσεων σφαλμάτων με κατάλληλους κωδικούς κατάστασης και μηνύματα — θεμελιώδες για οποιοδήποτε endpoint που ενδέχεται να αποτύχει (δεν βρέθηκε, απαγορεύεται, κακή κατάσταση).

Εξίσου πολύτιμο είναι ότι **τα σφάλματα επικύρωσης χειρίζονται αυτόματα** (αποτυχίες Pydantic παράγουν δομημένες απαντήσεις 422 χωρίς κώδικα από σας), και ότι **οι προσαρμοσμένοι χειριστές εξαιρέσεων** σας επιτρέπουν να αντιστοιχίσετε τις δικές σας εξαιρέσεις τομέα σε απαντήσεις και να επιβάλετε μια συνεπή μορφή σφάλματος σε όλο το API — βελτιώνοντας τόσο τη δυνατότητα συντήρησης (κεντρικοποιημένη λογική σφαλμάτων) όσο και την εμπειρία του πελάτη (προβλέψιμα σχήματα σφαλμάτων).

Η κατανόηση του `HTTPException`, των αυτόματων σφαλμάτων επικύρωσης και των προσαρμοσμένων χειριστών καλύπτει το πρακτικό φάσμα της διαχείρισης σφαλμάτων, καθιστώντας το σημαντική γνώση για την κατασκευή ισχυρών API.