Django async ORM의 경계: atomic을 sync_to_async로 감쌀 때 지켜야 할 것
뷰를 async def로 바꾸고 ORM에 await를 붙였다. 조회는 되는데 여러 쓰기를 하나의 트랜잭션으로 묶는 순간 설계가 복잡해진다. 비동기 문법의 존재와 트랜잭션 전체를 비동기로 실행할 수 있다는 것은 같은 뜻이 아니다.
기준: Django 5.2 · ASGI · asgiref. 이 글의 트랜잭션 제약은 Django 5.2 공식 문서를 기준으로 하며 다른 버전에 그대로 일반화하지 않는다.
DB 업무 단위를 하나의 동기 함수로 만든다
Django 5.2 문서는 async 모드에서 트랜잭션을 직접 처리하는 대신, 필요한 코드를 하나의 동기 함수로 작성하고 sync_to_async()로 호출하도록 안내한다. Django 비동기 지원
from asgiref.sync import sync_to_async
from django.db import transaction
from django.http import JsonResponse
def reserve_in_db(order_id, user_id):
with transaction.atomic():
order = (Order.objects.select_for_update()
.get(pk=order_id, user_id=user_id))
if order.status != "pending":
raise ValueError("order is not pending")
order.status = "reserved"
order.save(update_fields=["status"])
return {"id": order.pk, "status": order.status}
async def reserve_view(request, order_id):
user = await request.auser()
if not user.is_authenticated:
return JsonResponse({"error": "authentication required"}, status=401)
payload = await sync_to_async(
reserve_in_db, thread_sensitive=True,
)(order_id, user.pk)
return JsonResponse(payload)
뷰 예제는 인증·소유권 범위를 보여 주는 핵심 코드다. 실제 프로젝트에서는 POST 제한, CSRF 또는 API 인증 정책, DoesNotExist와 업무 오류의 응답 매핑을 추가한다. 핵심은 잠금 획득부터 변경까지 한 동기 함수 안에 있고, 반환값이 DB 접근을 더 요구하지 않는 dict라는 점이다.
QuerySet이나 connection을 경계 밖으로 내보내지 않는다
동기 함수가 Order.objects.filter(...)를 반환하면 실제 평가는 async 호출자 쪽에서 일어날 수 있다. 모델 인스턴스도 deferred 필드나 아직 로드되지 않은 관계에 접근하면 추가 쿼리를 실행할 수 있다.
따라서 필요한 필드와 관계를 경계 안에서 평가한 뒤 기본 타입으로 반환한다. connection.cursor 같은 연결 관련 객체를 다른 스레드로 전달하지도 않는다. DB 연결의 스레드 제약과 thread_sensitive의 목적을 이해하지 못한 채 False로 바꾸면 안 된다. synctoasync와 스레드 제약
작은 await 여러 개가 하나의 트랜잭션은 아니다
# 각각 별도 호출이라는 사실만으로 하나의 원자적 업무가 되지는 않는다.
order = await Order.objects.aget(pk=order_id)
order.status = "reserved"
await order.asave(update_fields=["status"])
다른 요청이 두 호출 사이에 상태를 바꿀 수 있다. 상태 전환이 단일 조건부 UPDATE로 표현 가능하다면 그 방법을 검토하고, 여러 읽기·쓰기가 묶여야 한다면 동기 트랜잭션 함수로 경계를 만든다.
asyncio.gather()로 ORM 호출을 많이 묶었다고 DB 병렬성이 무제한 늘어나는 것도 아니다. 어댑터 실행 문맥, 스레드 민감성, 연결 풀 크기, DB 잠금에 따라 실제 처리량은 달라진다. 이벤트 루프가 덜 막히는 효과와 DB 작업이 빨라지는 효과를 따로 측정한다.
연결 설정과 middleware도 함께 확인한다
Django 문서는 async 모드에서 CONN_MAX_AGE 기반 지속 연결을 비활성화하고 적절한 backend pooling 등을 검토하도록 안내한다. 동기 middleware가 async 스택 사이에 있으면 모드 전환과 스레드 유지 비용도 발생할 수 있다. 뷰 선언만 바꾸고 전체 요청 경로가 비동기가 됐다고 판단하지 않는다.
DJANGO_ALLOW_ASYNC_UNSAFE를 켜서 오류를 없애는 것은 해결책이 아니다. 보호 장치를 우회하는 설정이며 동시 접근의 안전성을 만들어 주지 않는다.
취소는 DB 롤백 명령이 아니다
클라이언트가 연결을 끊으면 async 뷰에 취소가 전달될 수 있다. 그러나 이미 별도 스레드에서 실행 중인 동기 함수가 즉시 중단됐다고 가정해서는 안 된다. 클라이언트의 재시도에는 별도의 멱등성이 필요하다.
검증에서는 응답 payload를 만드는 과정에서 추가 ORM 접근이 없는지, 트랜잭션 중 예외 시 변경이 함께 롤백되는지, 동기 middleware가 섞였을 때 처리량이 어떻게 변하는지 확인한다. 비동기 전환의 성공 기준은 await의 개수가 아니라 요청 전체의 동시성·일관성·자원 사용이 개선되는지다.
댓글
댓글 쓰기