의미
서버가 예상치 못한 상황을 만나 요청을 완료하지 못했습니다. 서버 측 오류를 포괄하는 일반 코드입니다.
흔한 원인
- 애플리케이션 코드의 처리되지 않은 예외나 버그
- 잘못된 .htaccess나 누락된 환경 변수 같은 설정 오류
- 더 적절한 상태로 매핑되지 않은 데이터베이스나 의존성 장애
해결 방법
클라이언트 또는 방문자라면
나중에 재시도하세요. 계속되면 시간과 응답의 요청 ID를 함께 알려 주세요.
사이트나 API 운영자라면
애플리케이션과 서버 오류 로그를 확인해 예외를 고치고, 원인을 알면 더 구체적인 코드(502, 503, 504)를 반환하세요.
응답 예시
HTTP/1.1
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Internal Server Error",
"status": 500,
"detail": "Something went wrong. Request id: 01J9Z6Q4K2."
}명세
자주 묻는 질문
› 500의 원인을 찾으려면?
요청 시각의 서버나 애플리케이션 오류 로그에서 스택 트레이스를 확인하세요. 디버그 모드는 개발 환경에서만 켜세요.
› .htaccess 파일이 500을 일으킬 수 있나요?
네. .htaccess의 구문 오류나 알 수 없는 지시어가 있으면 Apache가 500으로 응답합니다.