백엔드 · 기술

서버 런타임 오류

서버 애플리케이션 또는 그 실행 환경이 코드 실행, 파일·네트워크 접근, 자원 사용 중 반환하는 오류 코드와 메시지입니다.

정상 동작 조건

요약

서버 런타임 오류는 애플리케이션 프로세스가 실행·파일·네트워크·메모리 같은 동작을 처리하는 중 반환하는 오류 코드 또는 오류 메시지입니다. 오류 문자열은 문제를 식별하는 단서이며, 실제 원인은 실행 환경의 추가 관찰값으로 확인해야 합니다.

확인 절차

서버 런타임 오류는 실행 중인 애플리케이션 프로세스가 코드·파일·네트워크·메모리 같은 작업을 처리할 때 반환하는 오류 코드 또는 메시지입니다.

오류 문자열은 현재 실패를 식별하는 입력입니다. 문자열만으로 특정 코드, 호스팅, 네트워크 설정이 원인이라고 확정하지 않고, 해당 오류 문서에서 요구하는 화면·로그·실행 환경 값을 추가로 확인해야 합니다.

PHP도 웹 요청을 처리하는 서버 런타임 중 하나이지만, PHP 오류와 다른 런타임 오류는 같은 메시지라도 실행 환경과 확인 절차가 다를 수 있습니다.

관련 오류

Bad address

Python errno.EFAULT와 "Bad address" 메시지를 읽기 전용으로 대조하는 방법입니다.

Bad file number

Python errno.EBADF가 나타내는 "Bad file number" 오류를 원문 문자열과 대조해 식별합니다.

[8] System error: resource temporarily unavailable

Docker 컨테이너 실행 중 nproc 제한과 함께 표시되는 오류 메시지를 확인합니다.

EACCES (Permission denied)

Node.js에서 EACCES 오류 코드를 확인하고 파일 접근 권한으로 금지된 접근인지 식별합니다.

ECONNRESET (Connection reset by peer)

Node.js에서 상대방이 연결을 강제로 닫았을 때 나타나는 ECONNRESET 오류를 식별합니다.

EMFILE (Too many open files in system)

Node.js 공식 원문에 표시된 EMFILE (Too many open files in system) 항목의 문구를 확인하는 문서입니다.

ERR_CHILD_PROCESS_IPC_REQUIRED

Node.js에서 IPC 채널을 지정하지 않고 자식 프로세스를 fork할 때 사용하는 오류 코드입니다.

ERR_CHILD_PROCESS_STDIO_MAXBUFFER

Node.js 공식 원문에 표시된 ERR_CHILD_PROCESS_STDIO_MAXBUFFER 항목의 문구를 확인하는 문서입니다.

ERR_CRYPTO_INVALID_AUTH_TAG

Node.js에서 유효하지 않은 인증 태그가 제공되었을 때 표시되는 오류 코드입니다.

ERR_CRYPTO_INVALID_IV

Node.js에서 유효하지 않은 초기화 벡터가 제공되었음을 나타내는 오류 코드입니다.

ERR_CRYPTO_INVALID_KEYLEN

Node.js에서 유효하지 않은 암호화 키 길이가 제공되었을 때 식별하는 오류 코드입니다.

ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH

Node.js에서 crypto.timingSafeEqual()에 길이가 다른 Buffer, TypedArray 또는 DataView 인수를 전달할 때 식별하는 오류 코드입니다.

ERR_HTTP_CONTENT_LENGTH_MISMATCH

Node.js에서 응답 본문 크기와 content-length 헤더 값이 일치하지 않을 때 식별되는 오류 코드입니다.

ERR_HTTP_HEADERS_SENT

Node.js 공식 원문에 표시된 ERR_HTTP_HEADERS_SENT 항목의 문구를 확인하는 문서입니다.

ERR_HTTP_INVALID_HEADER_VALUE

Node.js에서 유효하지 않은 HTTP 헤더 값을 지정했을 때 식별되는 오류 코드입니다.

ERR_INCOMPATIBLE_OPTION_PAIR

Node.js에서 함께 사용할 수 없는 옵션 쌍을 동시에 사용할 때 식별하는 오류 코드입니다.

ERR_INVALID_ARG_TYPE

Node.js API에 잘못된 타입의 인수를 전달했을 때 표시되는 오류 코드입니다.

ERR_INVALID_ARG_VALUE

Node.js API 인수에 유효하지 않거나 지원되지 않는 값이 전달되었음을 나타내는 오류 코드입니다.

ERR_INVALID_PACKAGE_CONFIG

Node.js에서 `package.json` 파싱 실패를 나타내는 오류 코드입니다.

ERR_INVALID_PACKAGE_TARGET

Node.js 모듈 해석 중 package.json의 "exports" 대상 매핑 값이 유효하지 않을 때 식별하는 오류 코드입니다.

ERR_INVALID_URL

Node.js가 WHATWG URL 생성자 또는 legacy url.parse()에서 유효하지 않은 URL을 파싱할 때 발생하는 오류 코드입니다.

ERR_INVALID_URL_SCHEME

Node.js API에서 용도와 호환되지 않는 URL 스킴을 사용했을 때 발생하는 오류 코드입니다.

ERR_IPC_CHANNEL_CLOSED

Node.js에서 이미 닫힌 IPC 통신 채널을 사용하려 할 때 식별하는 오류 코드입니다.

ERR_MISSING_ARGS

Node.js API 호출에서 필수 인수가 전달되지 않았을 때 표시되는 ERR_MISSING_ARGS 오류를 식별합니다.

ERR_MISSING_OPTION

Node.js API에 필수 options 항목이 없을 때 발생하는 오류 코드입니다.

ERR_MODULE_NOT_FOUND

Node.js에서 ECMAScript 모듈 로더가 import 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 나타내는 오류 코드입니다.

ERR_OUT_OF_RANGE

Node.js에서 값이 허용 범위를 벗어났음을 나타내는 오류 코드입니다.

ERR_PACKAGE_IMPORT_NOT_DEFINED

Node.js에서 package.json의 imports 필드에 내부 패키지 지정자 매핑이 정의되지 않았음을 나타내는 오류 코드입니다.

ERR_REQUIRE_ASYNC_MODULE

Node.js 공식 원문에 표시된 ERR_REQUIRE_ASYNC_MODULE 항목의 문구를 확인하는 문서입니다.

ERR_SERVER_ALREADY_LISTEN

이미 수신 중인 net.Server에 server.listen()을 호출했을 때 표시되는 Node.js 오류 코드입니다.

ERR_SOCKET_BAD_PORT

Node.js에서 포트 범위 밖의 값을 전달했을 때 표시되는 오류 코드입니다.

ERR_SOCKET_CLOSED

Node.js에서 이미 닫힌 소켓에 작업을 시도했을 때 표시되는 오류 코드입니다.

ERR_SOCKET_CONNECTION_TIMEOUT

Node.js 공식 원문에 표시된 ERR_SOCKET_CONNECTION_TIMEOUT 항목의 문구를 확인하는 문서입니다.

ERR_STREAM_PREMATURE_CLOSE

stream.finished() 또는 stream.pipeline()에서 스트림이나 파이프라인이 명시적 오류 없이 정상적으로 끝나지 않을 때 반환되는 Node.js 오류 코드입니다.

ERR_STREAM_PUSH_AFTER_EOF

Node.js 스트림에 null(EOF)을 넣은 뒤 stream.push()를 호출했을 때 식별되는 오류 코드입니다.

ERR_STREAM_WRITE_AFTER_END

stream.end() 호출 뒤 stream.write()를 호출했을 때의 Node.js 오류 코드입니다.

ERR_TLS_HANDSHAKE_TIMEOUT

Node.js 공식 원문에 표시된 ERR_TLS_HANDSHAKE_TIMEOUT 항목의 문구를 확인하는 문서입니다.

ERR_TLS_PROTOCOL_VERSION_CONFLICT

Node.js 공식 원문에 표시된 ERR_TLS_PROTOCOL_VERSION_CONFLICT 항목의 문구를 확인하는 문서입니다.

ERR_WORKER_OUT_OF_MEMORY

Node.js Worker가 메모리 한도에 도달해 종료되었음을 나타내는 오류 코드입니다.

ERR_WORKER_PATH

Node.js 공식 원문에 표시된 ERR_WORKER_PATH 항목의 문구를 확인하는 문서입니다.

HPE_UNEXPECTED_CONTENT_LENGTH

Node.js가 HTTP 응답에서 Content-Length와 Transfer-Encoding: chunked가 함께 전송된 경우를 나타내는 오류 코드입니다.

I/O error

Python errno.EIO가 나타내는 I/O error를 식별합니다.

MODULE_NOT_FOUND

CommonJS 모듈 로더가 `require()` 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했음을 나타내는 Node.js 오류 코드입니다.

TimeoutError

Python에서 시스템 수준 시간 초과를 나타내는 TimeoutError를 로그에서 식별합니다.

Socket operation on non-socket

Python errno.ENOTSOCK 오류 코드와 메시지를 로그에서 식별하는 문서입니다.

참고 자료

Node.js · 공식 자료

확인 범위: runtime-error-codes, error-code-identification · 확인일: 2026-07-24