500서버 오류(5xx)
500 Internal Server Error — 서버 내부 오류
서버에서 예기치 못한 오류가 발생해 요청을 처리하지 못했다는 포괄적 응답입니다. 원인은 서버 로그에 있습니다.
언제 발생하나
처리되지 않은 예외, null 참조, DB 연결 실패, 환경변수 누락 등 서버 코드 문제에서 발생합니다.
실무 대응
- 서버 로그에서 스택 트레이스를 확인하는 것이 1순위입니다 — 500 자체엔 정보가 없습니다.
- 환경변수(특히 운영 환경) 누락, DB/외부 서비스 연결을 점검합니다.
- try/catch와 전역 에러 핸들러로 예외를 잡아 의미 있는 응답·로그를 남깁니다.
💡 실무 메모: Vercel 등에서는 함수 로그를 확인해야 원인이 보입니다. 클라이언트엔 500의 상세를 노출하지 말고 로그에만 남기세요.