Django에서 고유한 객체를 검색할 때 "first()" 사용을 피해야 하는 이유

7일 전

Django ORM을 사용하면서 고유한 객체를 검색할 때, `first()` 메서드를 사용하는 경우가 있는데 이는 예상치 못한 버그를 유발할 수 있습니다. 
이 글에서는 `first()` 메서드의 문제점과 이를 대체할 수 있는 안전한 방법을 살펴보겠습니다.

### `first()` 메서드의 문제점

`first()` 메서드는 쿼리셋에서 첫 번째 객체를 반환합니다. 
하지만 데이터베이스의 정렬 순서가 보장되지 않는 경우, `first()`가 반환하는 객체는 예측할 수 없습니다. 
이는 특히 고유한 객체를 검색할 때 문제가 됩니다.

예를 들어, `email` 필드가 고유하다고 가정하고, 해당 이메일을 가진 사용자를 찾으려면 다음과 같이 작성할 수 있습니다.

```python
user = User.objects.filter(email=email).first()
```

하지만 이 방법은 해당 이메일을 가진 여러 사용자가 존재할 경우, 첫 번째 사용자만 반환하고 나머지는 무시합니다. 
이는 데이터 무결성을 해칠 수 있습니다.

### 안전한 대안: `get()` 메서드

고유한 객체를 검색할 때는 `get()` 메서드를 사용하는 것이 좋습니다. 
`get()`은 조건에 맞는 객체가 하나뿐임을 보장하며, 없을 경우 `DoesNotExist` 예외를, 여러 개일 경우 `MultipleObjectsReturned` 예외를 발생시킵니다.

```python
try:
    user = User.objects.get(email=email)
except User.DoesNotExist:
    # 해당 이메일을 가진 사용자가 없음
except User.MultipleObjectsReturned:
    # 해당 이메일을 가진 사용자가 여러 명 존재
```

이렇게 하면 데이터의 고유성을 보장하고, 예외 처리를 통해 예상치 못한 상황에 대비할 수 있습니다.

### `get_object_or_404()`의 활용

Django에서는 `get()`과 함께 `get_object_or_404()`를 활용하여 객체를 가져오거나, 객체가 없을 경우 404 오류를 반환하도록 할 수 있습니다.

```python
from django.shortcuts import get_object_or_404

user = get_object_or_404(User, email=email)
```

이 방법은 웹 애플리케이션에서 특정 객체를 가져올 때 유용하며, 객체가 없을 경우 자동으로 404 페이지를 보여줍니다.

### 결론

Django에서 고유한 객체를 검색할 때 `first()` 메서드의 사용은 피하는 것이 좋습니다. 
대신 `get()`이나 `get_object_or_404()`를 사용하여 데이터의 무결성을 유지하고, 예외 처리를 통해 안정적인 코드를 작성하시기 바랍니다.
<br><br>
[Django: avoid using .first() when retrieving a unique object](https://django-orm-cookbook-ko.readthedocs.io/en/latest/distinct.html)

ORM first()

140

피토니

7일 전

댓글 0

답변 작성

이미지 첨부

아직 댓글이 없습니다. 첫번째 댓글 작성자가 되어주세요 :)