Что происходит, если get возвращает несколько записей?

В Django ORM метод get() — это удобный способ получить один объект модели, соответствующий заданным критериям поиска. Его основное предназначение — извлечение единственной записи, и он строго следует этому правилу.

Поведение метода get()

Когда вы вызываете Model.objects.get(...), Django выполняет SQL-запрос с условием WHERE. Ожидается, что в результате будет найдена ровно одна строка. Если запрос возвращает несколько строк, Django не может решить, какую из них вернуть, так как это нарушает контракт метода. Вместо того чтобы молча вернуть первую найденную запись (что могло бы привести к скрытым ошибкам), фреймворк генерирует исключение MultipleObjectsReturned. Это исключение является подклассом Model.DoesNotExist и сигнализирует об ошибке в логике запроса или о проблеме с целостностью данных.

Практический пример и обработка ошибок

Рассмотрим модель пользователя и попытку найти пользователя по неуникальному полю, например, по имени.

from django.core.exceptions import MultipleObjectsReturned, ObjectDoesNotExist
from myapp.models import User

try:
    # Попытка получить пользователя по имени 'John'
    user = User.objects.get(first_name='John')
except MultipleObjectsReturned:
    print("Найдено несколько пользователей с именем John! Используйте filter().")
except ObjectDoesNotExist:
    print("Пользователь с именем John не найден.")

В этом примере, если в базе несколько пользователей с именем 'John', будет выброшено исключение, и программа сможет корректно обработать эту ситуацию, например, предложив уточнить критерии поиска.

Когда использовать get() и когда filter()

• Используйте get(), когда вы уверены, что запрос должен вернуть ровно один объект. Это типично для поиска по первичному ключу (id) или по полям с ограничением unique=True.
• Используйте filter(), когда ожидаете ноль, один или несколько объектов. Метод filter() возвращает QuerySet, с которым можно работать дальше: users = User.objects.filter(first_name='John').

Вывод: Исключение MultipleObjectsReturned — это защитный механизм Django, который предотвращает неявные ошибки. Используйте get() только для уникальных запросов, а для всех остальных случаев, особенно когда возможны дубликаты, применяйте filter(). Это делает код более предсказуемым и устойчивым.