본문 바로가기
Q&A2026년 4월 19일2분 읽기

Prisma transaction 안에서 $queryRaw 썼더니 "already in a transaction" 에러가 납니다

주
주니어개발자소연
조회 496댓글 3

Prisma로 트랜잭션 안에서 raw SQL을 섞어 쓰려는데, 이런 에러가 발생합니다.

PrismaClientKnownRequestError:
Transaction API error: Transaction already closed:
A query cannot be executed on a transaction which has been committed or rolled back.

코드는 이렇게 생겼습니다.

await prisma.$transaction(async (tx) => {
  await tx.user.update({ where: { id }, data: { balance: { decrement: 100 } } });
  await prisma.$queryRaw`UPDATE ledger SET ...`;   // ← 이거 문제?
  await tx.transfer.create({ data: { ... } });
});

동시에 DB lock이 길어진다는 경고도 같이 뜹니다. 트랜잭션 안에서 raw query를 섞는 올바른 방법이 있나요?

댓글 3

김김영삼7개월 전

핵심 원인은 트랜잭션 바깥의 prisma를 호출한 것입니다. 이 줄이 문제예요:


await prisma.$queryRaw`...`;  // ❌ 트랜잭션 밖의 커넥션 사용

Prisma의 $transaction 콜백은 매개변수로 받은 tx가 그 트랜잭션을 소유한 커넥션입니다. 반드시 tx로만 쿼리해야 같은 트랜잭션에 포함됩니다.


올바른 형태
await prisma.$transaction(async (tx) => {
await tx.user.update({ where: { id }, data: { balance: { decrement: 100 } } });
await tx.$queryRaw`UPDATE ledger SET amount = amount + 100 WHERE user_id = ${id}`;
await tx.transfer.create({ data: { ... } });
});

보시다시피 tx.$queryRaw로 호출합니다. tx.$executeRaw도 동일하게 존재합니다.


왜 "already closed" 에러가 났나

트랜잭션 타임아웃(기본 5초) 안에서 prisma.$queryRaw가 다른 커넥션을 잡으려 하다가 풀이 막혀서 대기 → 트랜잭션은 타임아웃으로 자동 롤백 → 그 뒤 tx.transfer.create가 이미 닫힌 트랜잭션에 접근 → 해당 에러. 체인의 결과입니다.


타임아웃 튜닝
await prisma.$transaction(async (tx) => {
// ...
}, {
maxWait: 5000, // 트랜잭션 시작 전 대기 한계
timeout: 15000, // 트랜잭션 전체 시간
isolationLevel: Prisma.TransactionIsolationLevel.ReadCommitted,
});

lock 길어지는 문제

트랜잭션 안에서 외부 API 호출·긴 연산·for 루프가 있으면 DB row lock이 그 시간 전부 유지됩니다. 다음을 확인하세요:



  • 트랜잭션 안에서 await fetch() 같은 외부 호출 금지

  • 반복문은 트랜잭션 바깥에서 데이터 준비하고, 안에서는 쿼리만

  • 긴 작업은 SELECT FOR UPDATE SKIP LOCKED로 잠금 대상 줄이기


참고: 인터랙티브 트랜잭션 vs 순차 배열

요청 순서가 자명한 작업은 배열 버전이 더 안전합니다.


await prisma.$transaction([
prisma.user.update({ ... }),
prisma.$executeRaw`UPDATE ledger ...`,
prisma.transfer.create({ ... }),
]);

단, 이 형태는 앞 쿼리 결과를 다음 쿼리에 넘길 수 없습니다. 조건부/의존 로직이 있으면 콜백 버전 사용.

코코딩하는민수7개월 전

저도 예전에 같은 실수했어요. prisma와 tx가 변수명이 비슷해서 자동완성 하다가 은근히 섞입니다. ESLint 커스텀 룰로 콜백 안에서 prisma.* 호출 금지를 걸어두면 예방돼요.

주주니어개발자소연7개월 전

tx.$queryRaw로 바꾸니 바로 해결됐습니다. 트랜잭션 안 외부 API 호출 지적도 맞아서, 그 부분은 트랜잭션 밖으로 뺐습니다. ESLint 커스텀 룰 아이디어 좋네요, 적용해 봐야겠어요. 감사합니다!

Ctrl+Enter로 등록