백엔드 · 오류·증상

Unique constraint failed on the {constraint}

저자: Woody
최종 검토: 2026-07-24
참고 자료: 있음
관련 기술: 데이터베이스 오류 코드

빠른 답변

이 오류는 무엇인가요?: Prisma Client Query Engine의 P2002 오류 메시지를 식별하는 문서입니다.
가장 흔한 원인은 무엇인가요?: P2002는 `Unique constraint failed on the {constraint}` 메시지로 표시되는 Prisma Client Query Engine 오류 코드입니다.
무엇을 먼저 확인해야 하나요?: 현재 화면 또는 로그의 오류 코드가 `P2002`인지 확인합니다.

현재 증상

애플리케이션 오류 메시지

먼저 확인할 항목

현재 화면 또는 로그의 오류 코드가 `P2002`인지 확인합니다.

현재 오류 메시지가 `Unique constraint failed on the {constraint}` 형식인지 원문 메시지와 비교합니다.

오류 코드와 메시지가 모두 일치하면 P2002로 식별합니다.

환경별 원인과 조치

확인

현재 화면 또는 로그의 오류 코드가 P2002인지 확인합니다.
오류 메시지가 Unique constraint failed on the {constraint} 형식인지 확인합니다.
두 값이 모두 일치하면 Prisma Error Reference에 정의된 P2002 오류로 식별합니다.

의미

Prisma Error Reference는 P2002를 Prisma Client Query Engine의 오류 코드로 나열하고, 이 메시지를 고유 제약 조건 실패로 설명합니다.

출처: Prisma Error Reference (새 창에서 열림)

참고 자료

Errors | Prisma Documentation

Prisma · 공식 자료 · 확인 범위: Prisma Client Query Engine 오류 코드 P2002의 메시지는 `Unique constraint failed on the {constraint}`입니다., PrismaClientKnownRequestError는 요청과 관련된 알려진 오류가 반환될 때 발생하며, 고유 제약 조건 위반이 예시로 제시됩니다. · 확인일: 2026-07-24