FastAPI + SQLAlchemy 2.0 async에서 deadlock이 가끔 발생합니다

Question

FastAPI + SQLAlchemy 2.0 async + PostgreSQL 환경입니다. 로컬·스테이징은 멀쩡한데 운영에서 트래픽이 살짝만 올라가면 asyncpg.exceptions.DeadlockDetectedError가 가끔 떨어집니다.

같은 트랜잭션 안에서 여러 테이블을 업데이트하는 부분이 있는데, 항상 동일 순서로 락을 잡도록 해도 사라지지 않습니다.

혹시 async session·connection pool 차원에서 deadlock이 생기는 패턴이 있을까요?

김영삼 · Accepted Answer

asyncpg deadlock은 두 가지 다른 원인이 종종 섞입니다 — 진단 방향을 명확히 잡아야 합니다.1) PostgreSQL 측 deadlock (실제 락 충돌)로그에 Process 1234 waits for ShareLock... Process 5678 waits for ... 형태가 찍힙니다. 이건 정직하게 두 트랜잭션이 서로의 락을 기다리는 상황이고, 락 획득 순서를 통일하거나 SELECT ... FOR UPDATE OF로 좁혀야 합니다.2) Async session 재사용으로 인한 가짜 deadlock실무에서 더 자주 보는 케이스입니다. AsyncSession 하나를 여러 코루틴이 동시에 사용하면 SQLAlchemy 내부 상태가 꼬이면서 deadlock처럼 보이는 에러가 납니다.잘못된 패턴:session = async_session()  # 모듈 레벨에 두는 실수

async def handler():
    await asyncio.gather(
        sess

댓글 0