DEV WIKI
백엔드 · 오류·증상

unique_violation

저자
Woody
최종 검토
2026-07-24
참고 자료
있음
관련 기술

빠른 답변

이 오류는 무엇인가요?
PostgreSQL SQLSTATE 23505는 unique_violation 조건을 나타내는 오류 코드입니다.
가장 흔한 원인은 무엇인가요?
현재 오류 보고의 SQLSTATE가 23505이면 PostgreSQL의 unique_violation 조건이며, 무결성 제약 조건 위반 Class 23에 속합니다.
무엇을 먼저 확인해야 하나요?
현재 PostgreSQL 오류 보고의 SQLSTATE 값을 읽기 전용으로 확인합니다.

현재 증상

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

먼저 확인할 항목

현재 PostgreSQL 오류 보고의 SQLSTATE 값을 읽기 전용으로 확인합니다.

확인한 SQLSTATE 문자열이 `23505`와 정확히 일치하면 `unique_violation` 조건으로 판정합니다.

오류 보고에 관련 데이터베이스 객체 이름이 별도 필드로 제공되는지 확인합니다.

환경별 원인과 조치

확인

현재 PostgreSQL 오류 보고에서 SQLSTATE 값을 확인합니다.

  • 값이 23505이면 이 문서의 대상 조건은 unique_violation입니다.
  • 23505는 SQLSTATE Class 23인 무결성 제약 조건 위반에 속합니다.

PostgreSQL은 사람이 읽는 오류 메시지 대신 오류 코드를 검사하는 방식을 일반적으로 권장합니다. 오류 보고에 관련 데이터베이스 객체 이름이 별도 필드로 제공되면 해당 필드를 함께 확인합니다.

범위

이 문서는 23505 코드 식별만 다룹니다. 원문은 이 코드에 대한 원인 분석이나 복구 절차를 제공하지 않습니다.

참고 자료

PostgreSQL: Documentation: 18: Appendix A. PostgreSQL Error Codes (새 창에서 열림)

PostgreSQL · 공식 자료 · 확인 범위: PostgreSQL 서버 메시지에는 다섯 글자 SQLSTATE 오류 코드가 할당됩니다., 오류 조건을 확인해야 하는 애플리케이션은 일반적으로 사람이 읽는 오류 메시지보다 오류 코드를 검사해야 합니다., 23505의 condition name은 unique_violation입니다., 23505는 Class 23 Integrity Constraint Violation에 속합니다., SQLSTATE Class 23 오류는 관련 데이터베이스 객체 이름을 별도 오류 보고 필드로 제공할 수 있습니다. · 확인일: 2026-07-24