백엔드 · 오류·증상

ERR_SERVER_ALREADY_LISTEN

저자: Woody
최종 검토: 2026-07-24
참고 자료: 있음
관련 기술: 서버 런타임 오류

빠른 답변

이 오류는 무엇인가요?: 이미 수신 중인 net.Server에 server.listen()을 호출했을 때 표시되는 Node.js 오류 코드입니다.
가장 흔한 원인은 무엇인가요?: ERR_SERVER_ALREADY_LISTEN은 이미 수신 중인 net.Server에 server.listen()을 호출했음을 나타냅니다.
무엇을 먼저 확인해야 하나요?: 현재 오류 객체 또는 로그의 오류 코드가 `ERR_SERVER_ALREADY_LISTEN`인지 확인합니다.

현재 증상

애플리케이션 오류 메시지

먼저 확인할 항목

현재 오류 객체 또는 로그의 오류 코드가 `ERR_SERVER_ALREADY_LISTEN`인지 확인합니다.

오류 코드가 일치하면 이미 수신 중인 `net.Server`에 `server.listen()`이 호출된 경우로 판정합니다.

환경별 원인과 조치

의미

ERR_SERVER_ALREADY_LISTEN은 이미 수신 중인 net.Server에 server.listen() 메서드를 호출했음을 나타냅니다. HTTP, HTTPS, HTTP/2 Server를 포함한 모든 net.Server 인스턴스에 적용됩니다.

확인

현재 화면 또는 로그의 error.code 값이 ERR_SERVER_ALREADY_LISTEN과 일치하는지 확인합니다.
일치하면 해당 오류는 이미 수신 중인 서버에 server.listen()을 호출한 경우로 식별합니다.

Node.js는 오류 메시지 문자열이 버전 사이에 변경될 수 있으므로 오류 식별에 error.code 사용을 권장합니다.

출처

Node.js Errors 문서 (새 창에서 열림)

참고 자료

Errors | Node.js v26.5.0 Documentation

Node.js · 공식 자료 · 확인 범위: Node.js는 오류 식별에 error.message 대신 error.code 사용을 권장합니다., ERR_SERVER_ALREADY_LISTEN은 이미 수신 중인 net.Server에 server.listen()을 호출했을 때 발생합니다., 이 오류는 HTTP, HTTPS, HTTP/2 Server를 포함한 모든 net.Server 인스턴스에 적용됩니다. · 확인일: 2026-07-24