Las aplicaciones FastAPI gestionan la configuración con pydantic-settings (BaseSettings) — una clase que lee la configuración desde variables de entorno (y archivos .env) con , manteniendo secretos fuera del código y asegurando que la configuración sea correcta al iniciar.
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 lee automáticamente cada campo desde una variable de entorno coincidente (p. ej. DATABASE_URL), convierte tipos ("true" → bool, "10" → int) y valida — un valor requerido faltante o un tipo incorrecto falla inmediatamente al iniciar con un error claro (fallar rápido).
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}
Inyectar la configuración mediante una dependencia cacheada la hace testeable (anular en pruebas) y asegura una sola instancia.
# .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)
La gestión adecuada de la configuración es tanto una necesidad operacional (las aplicaciones necesitan diferente configuración en dev/staging/production) como un requisito de seguridad (secretos como URLs de base de datos y claves nunca deben estar codificados en el control de versiones — una brecha común y grave).
El BaseSettings de Pydantic proporciona la solución idiomática de FastAPI, y entenderlo es un conocimiento importante de todos los días.
Sus ventajas clave: leer configuración desde variables de entorno (manteniendo secretos fuera del código, el enfoque de doce factores) con conversión de tipos y validación automáticas — así que la configuración incorrecta falla rápidamente al iniciar con un error claro en lugar de un fallo confuso en tiempo de ejecución.
Combinado con la inyección de dependencias (haciendo que la configuración sea testeable y singleton) y la práctica de archivos .env ignorados por git para desarrollo local, esto le proporciona una configuración segura, validada y apropiada para el entorno.
Saber cómo definir la configuración, usarla mediante DI y manejar secretos de forma segura es fundamental para crear aplicaciones FastAPI listas para producción.