FastAPI 0.106 est sorti
par Makersquad ·
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.