Aller au contenu
Makersquad

FastAPI 0.106 est sorti

par Makersquad ·

Logo de FastAPI sur fond dégradé

Date de sortie : 25 décembre 2023

Release officielle : FastAPI 0.106.0

Une release courte mais qui casse : le comportement des dépendances yield change dans leur interaction avec HTTPException et les background tasks. Si vous partagez une ressource issue d’une dépendance yield avec une background task, cette release peut affecter votre code. La release officielle 0.106.0 (s’ouvre dans un nouvel onglet) détaille l’ensemble des changements.

Ce qui change

HTTPException après yield

À partir de cette version, lever HTTPException dans le code après yield (donc dans la phase de nettoyage) devient possible, ce qui ne l’était pas auparavant. Avant, le code de sortie s’exécutait après l’envoi de la réponse, ce qui empêchait les gestionnaires d’exception de s’exécuter.

from fastapi import Depends, FastAPI, HTTPException
from typing_extensions import Annotated

app = FastAPI()


data = {
    "plumbus": {"description": "Freshly pickled plumbus", "owner": "Morty"},
    "portal-gun": {"description": "Gun to create portals", "owner": "Rick"},
}


class OwnerError(Exception):
    pass


def get_username():
    try:
        yield "Rick"
    except OwnerError as e:
        raise HTTPException(status_code=400, detail=f"Owner error: {e}")


@app.get("/items/{item_id}")
def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
    if item_id not in data:
        raise HTTPException(status_code=404, detail="Item not found")
    item = data[item_id]
    if item["owner"] != username:
        raise OwnerError(username)
    return item

Cet exemple est celui de la release 0.106.0.

Background tasks et dépendances yield

Avant cette version, le code de nettoyage (après yield) s’exécutait une fois que les background tasks avaient terminé, ce qui permettait à ces tâches d’utiliser une ressource issue d’une dépendance yield. Désormais, il s’exécute immédiatement, avant l’envoi de la réponse au client. Les background tasks qui dépendaient d’une ressource yield recevaient donc cette ressource déjà fermée. Utiliser une ressource d’une dépendance yield dans une background task n’est plus supporté.

Ce comportement a ensuite été annulé en 0.118.0 (29 septembre 2025) : le code de sortie après yield s’exécute de nouveau après l’envoi de la réponse, ce qui permet par exemple à une StreamingResponse d’utiliser une session de base de données ouverte par une dépendance yield.

async def get_db():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()  # appelé AVANT la background task

async def save_log(db: DB):
    # problème si db vient d'une dépendance yield
    db.add(log_entry)

@app.post("/items")
async def create_item(
    background_tasks: BackgroundTasks,
    db: DB = Depends(get_db),
):
    background_tasks.add_task(save_log, db)  # db fermé

Comment migrer

  • Si vous avez besoin d’une ressource dans une background task, créez-la dans la task elle-même, pas via une dépendance yield. Par exemple, passez un identifiant plutôt que l’objet, et récupérez l’objet avec une nouvelle connexion à l’intérieur de la tâche.

À retenir

Le changement est subtil mais impactant. La doc FastAPI a été mise à jour avec les nouveaux patterns recommandés. Vérifiez vos dépendances yield lors de la montée de version, en particulier celles partagées avec des background tasks. Ce comportement a été annulé en 0.118.0 : vérifiez la version que vous visez.

Échanger avec un expert FastAPI

De l’idée au marché. Makersquad conçoit des logiciels sur mesure, pensés pour durer, avec de petites équipes d’experts autonomes. Depuis 2018.