DEV WIKI
백엔드 · 오류 메시지·상태명 확인

Unique constraint failed on the {constraint}

Prisma Client Query Engine의 P2002 오류 메시지를 식별하는 문서입니다.

빠른 답변

확인 범위
P2002는 `Unique constraint failed on the {constraint}` 메시지로 표시되는 Prisma Client Query Engine 오류 코드입니다.
먼저 확인할 항목
현재 화면 또는 로그의 오류 코드가 `P2002`인지 확인합니다.
적용 범위
화면 또는 로그에 같은 오류 메시지·상태명이 표시된 경우문맥: 바이브 코딩
출처
Prisma
출처 확인일
2026-07-24
최종 검토
2026-07-24
오류·수정 제보 (새 창에서 열림)

이 문서의 범위

이 문서는 화면·로그의 오류 메시지 또는 상태명을 공식 자료와 대조하는 데 사용합니다. 이 문구만으로 실제 원인이나 변경 방법을 확정하지 않으며, 아래 관련 기술 문서에서 적용 환경을 추가로 확인해야 합니다.

현재 증상

  • 애플리케이션 오류 메시지

먼저 확인할 항목

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

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

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

오류 메시지·상태명 확인 범위

확인

  1. 현재 화면 또는 로그의 오류 코드가 P2002인지 확인합니다.
  2. 오류 메시지가 Unique constraint failed on the {constraint} 형식인지 확인합니다.
  3. 두 값이 모두 일치하면 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