Как использовать model_config для включения режимов populate_by_name, strict или from_attributes?

Ключевые опции model_config в Pydantic v2

Поведение модели настраивается через ConfigDict, который передаётся в атрибут класса model_config. Три наиболее практически важные опции — populate_by_name, strict и from_attributes.

populate_by_name

По умолчанию, если поле имеет alias, оно принимает только alias. Опция populate_by_name=True разрешает использовать и имя поля, и alias одновременно.

from pydantic import BaseModel, ConfigDict, Field

class UserAPI(BaseModel):
    model_config = ConfigDict(populate_by_name=True)

    user_id: int = Field(alias="userId")
    full_name: str = Field(alias="fullName")

# Через alias (как приходит из API)
u1 = UserAPI.model_validate({"userId": 1, "fullName": "Alice"})
print(u1.user_id)  # 1

# Через snake_case имя (удобно в тестах и внутреннем коде)
u2 = UserAPI.model_validate({"user_id": 2, "full_name": "Bob"})
print(u2.full_name)  # Bob

# Без populate_by_name строка выше бросила бы ValidationError

Типичный кейс: модель получает данные из внешнего JSON-API с camelCase, но внутри кода хочется snake_case.

strict

По умолчанию Pydantic делает мягкое приведение типов (lax mode): строка "42" принимается для поля int. strict=True запрещает любой coercion — типы должны совпадать точно.

from pydantic import BaseModel, ConfigDict, ValidationError

class StrictOrder(BaseModel):
    model_config = ConfigDict(strict=True)

    quantity: int
    price: float
    active: bool

# OK — точные типы
order = StrictOrder(quantity=5, price=9.99, active=True)

# Падает — строка не принимается для int
try:
    StrictOrder(quantity="5", price=9.99, active=True)
except ValidationError as e:
    print(e.errors()[0]["type"])  # int_type

# Падает — int не принимается для bool
try:
    StrictOrder(quantity=5, price=9.99, active=1)
except ValidationError as e:
    print(e.errors()[0]["type"])  # bool_type

Strict mode полезен для внутренних API и моделей данных, где типы известны заранее, — он делает ошибки явными на раннем этапе.

from_attributes

Разрешает создавать модель из объектов с атрибутами (ORM-объекты, dataclasses, NamedTuple) вместо словарей. Аналог orm_mode = True из Pydantic v1.

from pydantic import BaseModel, ConfigDict
from sqlalchemy import Column, Integer, String
from sqlalchemy.orm import DeclarativeBase

class Base(DeclarativeBase):
    pass

class UserORM(Base):
    __tablename__ = "users"
    id = Column(Integer, primary_key=True)
    name = Column(String)
    email = Column(String)

class UserSchema(BaseModel):
    model_config = ConfigDict(from_attributes=True)

    id: int
    name: str
    email: str

# Симулируем ORM-объект
class FakeORM:
    id = 1
    name = "Alice"
    email = "alice@example.com"

user = UserSchema.model_validate(FakeORM())
print(user.name)  # Alice
print(user.model_dump())  # {'id': 1, 'name': 'Alice', 'email': 'alice@example.com'}

Комбинирование опций

from pydantic import BaseModel, ConfigDict, Field

class RobustModel(BaseModel):
    model_config = ConfigDict(
        from_attributes=True,    # принимает ORM-объекты
        populate_by_name=True,   # принимает и alias, и имя поля
        strict=False,            # мягкая типизация (дефолт)
        validate_assignment=True, # валидирует при присвоении атрибутов
    )

    user_id: int = Field(alias="userId")
    status: str

Подводные камни

• strict=True на уровне модели влияет на все поля сразу. Если нужен strict только для одного поля, используйте Annotated[int, Strict()] на уровне поля.
• populate_by_name=True не меняет поведение сериализации — model_dump(by_alias=True) по-прежнему нужно вызывать явно, иначе в выводе будут snake_case имена.
• from_attributes=True читает атрибуты через getattr(), а не через __dict__ — это важно для ленивых SQLAlchemy-атрибутов, которые могут вызвать DetachedInstanceError при доступе вне сессии.
• Если задан alias_generator (например, alias_generator=str.lower) и populate_by_name=False, можно случайно сломать инициализацию по ключевым аргументам.
• model_config не наследуется автоматически так, как можно ожидать: дочерний класс наследует конфиг родителя, но если переопределить хоть одну опцию через новый ConfigDict(), остальные сбрасываются в дефолт — нужно явно указывать все нужные опции.
• Опция validate_assignment=True делает модель «живой» — присвоение model.field = value валидируется, но это добавляет overhead при частых мутациях.

• Описывать model config options только как термин и не показывать механизм на минимальном примере.
• Игнорировать ошибки, пустые данные, конкурентный доступ или границы транзакции.
• Не связывать поведение с официальным контрактом Pydantic и реальной эксплуатацией.

• Объясняет model config options через последовательность действий, а не через набор ключевых слов.
• Приводит короткий кодовый пример или production-сценарий с ожидаемым поведением.
• Называет хотя бы один риск: производительность, безопасность, транзакции, память или сопровождение.