DEV WIKI
백엔드 · 오류·증상

The database server at {database_host}:{database_port} was reached but timed out. Please try again. Please make sure your database server is running at {database_host}:{database_port}.

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

빠른 답변

이 오류는 무엇인가요?
Prisma P1002 오류 메시지를 확인해 데이터베이스 서버에 도달한 뒤 시간 초과된 상태를 식별합니다.
가장 흔한 원인은 무엇인가요?
P1002는 Prisma가 지정한 데이터베이스 호스트와 포트에 도달했지만 시간 초과되었음을 나타냅니다.
무엇을 먼저 확인해야 하나요?
오류 화면 또는 로그의 오류 코드가 `P1002`인지 확인합니다.

현재 증상

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

먼저 확인할 항목

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

표시된 오류 메시지가 Prisma 문서의 P1002 메시지 형식과 일치하는지 확인합니다.

메시지에 표시된 데이터베이스 호스트와 포트 값을 확인합니다.

환경별 원인과 조치

확인 방법

오류 화면 또는 로그에서 오류 코드가 P1002인지 확인합니다.

표시된 메시지가 다음 형식과 일치하는지 확인합니다.

The database server at {database_host}:{database_port} was reached but timed out. Please try again. Please make sure your database server is running at {database_host}:{database_port}.

{database_host}{database_port} 위치에는 현재 연결에 사용된 호스트와 포트 값이 표시됩니다.

이 코드와 메시지가 일치하면 Prisma는 해당 데이터베이스 서버에 도달했지만 시간 초과된 상태를 보고한 것입니다.

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

참고 자료

Errors | Prisma Documentation (새 창에서 열림)

Prisma · 공식 자료 · 확인 범위: P1002의 오류 메시지는 데이터베이스 서버에 도달했지만 시간 초과되었다고 표시합니다., P1002 메시지에는 데이터베이스 호스트와 포트 값이 포함됩니다. · 확인일: 2026-07-24