FastAPI приложения управляют конфигурацией с помощью pydantic-settings (BaseSettings) — класса, который читает конфигурацию из переменных окружения (и файлов .env) с , сохраняя secrets вне кода и обеспечивая корректность конфигурации при запуске.
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 автоматически читает каждое поле из соответствующей переменной окружения (например DATABASE_URL), преобразует типы ("true" → bool, "10" → int) и валидирует — отсутствующее обязательное значение или неправильный тип немедленно приводит к ошибке при запуске с понятным сообщением (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}
Внедрение настроек через закэшированную зависимость делает их тестируемыми (переопределение в тестах) и гарантирует единственный экземпляр.
# .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)
Правильное управление настройками — это одновременно операционная необходимость (приложениям нужна разная конфигурация для разработки/staging/production) и требование безопасности (secrets, такие как URL базы данных и ключи, никогда не должны быть захардкодены в исходный контроль — частое и серьёзное нарушение).
BaseSettings Pydantic обеспечивает идиоматичное решение для FastAPI, и понимание его — важные повседневные знания.
Основные преимущества: чтение конфигурации из переменных окружения (сохранение secrets вне кода, подход twelve-factor) с автоматическим преобразованием типов и валидацией — так что ошибки в конфигурации обнаруживаются быстро при запуске с понятной ошибкой, а не как запутанный сбой времени выполнения.
Вместе с dependency injection (делающим настройки тестируемыми и singleton) и практикой gitignored файлов .env для локальной разработки, это обеспечивает вам безопасную, валидированную, соответствующую окружению конфигурацию.
Знание того, как определять настройки, использовать их через DI и безопасно обрабатывать secrets, является фундаментальным для создания production-ready FastAPI приложений.