FastAPI-Anwendungen verwalten die Konfiguration mit pydantic-settings (BaseSettings) — eine Klasse, die config aus Umgebungsvariablen (und .env-Dateien) mit liest und Geheimnisse aus dem Code hält und sicherstellt, dass die Config beim Start korrekt ist.
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
app_name: str = "My API"
database_url: str # required — must be provided
secret_key: str # required (a secret)
debug: bool = False
max_connections: int = 10
class Config:
env_file = ".env" # also read from a .env file
settings = Settings() # reads & VALIDATES env vars at startup
BaseSettings liest automatisch jedes Feld aus einer entsprechenden Umgebungsvariablen (z.B. DATABASE_URL), konvertiert Typen ("true" → bool, "10" → int) und validiert — ein fehlender erforderlicher Wert oder falscher Typ schlägt sofort beim Start mit einer klaren Fehlermeldung fehl (fail-fast).
from functools import lru_cache
from fastapi import Depends
@lru_cache # create the Settings once (cached)
def get_settings():
return Settings()
@app.get("/info")
def info(settings: Settings = Depends(get_settings)):
return {"app": settings.app_name, "debug": settings.debug}
Das Injizieren von Einstellungen über eine gecachte Abhängigkeit macht sie testbar (Überschreibung in Tests) und sichert eine einzelne Instanz.
# .env — local config, GITIGNORED (never commit secrets)
DATABASE_URL=postgresql://localhost/mydb
SECRET_KEY=dev-secret
DEBUG=true
✓ Keep secrets in env vars / .env (gitignored); commit a .env.example documenting keys
✓ In production, inject config via the platform's environment / secret manager
✓ Validation at startup catches misconfiguration immediately (not deep in a request)
Ordnungsgemäße Einstellungsverwaltung ist sowohl eine operative Notwendigkeit (Apps benötigen verschiedene Konfigurationen in dev/staging/production) als auch eine Sicherheitsanforderung (Geheimnisse wie Datenbank-URLs und Schlüssel dürfen niemals in der Versionskontrolle hartcodiert werden — eine häufige, schwerwiegende Verletzung).
Pydantic's BaseSettings bietet die idiomatische FastAPI-Lösung, und deren Verständnis ist wichtiges alltägliches Wissen.
Seine Schlüsselvorteile: config aus Umgebungsvariablen lesen (Geheimnisse aus dem Code halten, the twelve-factor approach) mit automatischer Typkonvertierung und Validierung — so schlägt Fehlkonfiguration schnell beim Start mit einer klaren Fehlermeldung fehl, anstatt als verwirrend zur Laufzeit zu scheitern.
In Kombination mit Dependency Injection (das Einstellungen testbar und Singleton macht) und der Praxis von gitignored .env-Dateien für die lokale Entwicklung erhalten Sie sichere, validierte, umgebungsgerechte Konfiguration.
Zu wissen, wie man Einstellungen definiert, sie über DI verwendet und Geheimnisse sicher handhabt, ist grundlegend für den Aufbau produktionsreifer FastAPI-Anwendungen.