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
핵심 원인은 트랜잭션 바깥의
prisma를 호출한 것입니다. 이 줄이 문제예요:Prisma의
$transaction콜백은 매개변수로 받은tx가 그 트랜잭션을 소유한 커넥션입니다. 반드시tx로만 쿼리해야 같은 트랜잭션에 포함됩니다.올바른 형태
보시다시피
tx.$queryRaw로 호출합니다.tx.$executeRaw도 동일하게 존재합니다.왜 "already closed" 에러가 났나
트랜잭션 타임아웃(기본 5초) 안에서
prisma.$queryRaw가 다른 커넥션을 잡으려 하다가 풀이 막혀서 대기 → 트랜잭션은 타임아웃으로 자동 롤백 → 그 뒤tx.transfer.create가 이미 닫힌 트랜잭션에 접근 → 해당 에러. 체인의 결과입니다.타임아웃 튜닝
lock 길어지는 문제
트랜잭션 안에서 외부 API 호출·긴 연산·for 루프가 있으면 DB row lock이 그 시간 전부 유지됩니다. 다음을 확인하세요:
await fetch()같은 외부 호출 금지SELECT FOR UPDATE SKIP LOCKED로 잠금 대상 줄이기참고: 인터랙티브 트랜잭션 vs 순차 배열
요청 순서가 자명한 작업은 배열 버전이 더 안전합니다.
단, 이 형태는 앞 쿼리 결과를 다음 쿼리에 넘길 수 없습니다. 조건부/의존 로직이 있으면 콜백 버전 사용.
저도 예전에 같은 실수했어요.
prisma와tx가 변수명이 비슷해서 자동완성 하다가 은근히 섞입니다. ESLint 커스텀 룰로 콜백 안에서prisma.*호출 금지를 걸어두면 예방돼요.tx.$queryRaw로 바꾸니 바로 해결됐습니다. 트랜잭션 안 외부 API 호출 지적도 맞아서, 그 부분은 트랜잭션 밖으로 뺐습니다. ESLint 커스텀 룰 아이디어 좋네요, 적용해 봐야겠어요. 감사합니다!