ECONNRESET (Connection reset by peer)
빠른 답변
- 이 오류는 무엇인가요?
- Node.js에서 상대방이 연결을 강제로 닫았을 때 나타나는 ECONNRESET 오류를 식별합니다.
- 가장 흔한 원인은 무엇인가요?
- ECONNRESET은 상대방이 연결을 강제로 닫았음을 나타내며, 원격 소켓 연결이 시간 초과되거나 재부팅되어 끊긴 경우에 일반적으로 발생합니다.
- 무엇을 먼저 확인해야 하나요?
- 오류 객체 또는 로그의 error.code 값이 ECONNRESET과 일치하는지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
오류 객체 또는 로그의 error.code 값이 ECONNRESET과 일치하는지 확인합니다.
환경별 원인과 조치
확인
- 오류 객체 또는 로그에서
error.code값을 확인합니다. - 값이
ECONNRESET과 일치하면 Node.js가 정의한 연결 재설정 오류입니다.
의미
상대방이 연결을 강제로 닫았습니다. 원문은 원격 소켓 연결이 시간 초과되거나 재부팅되어 연결이 끊긴 경우가 일반적인 발생 상황이라고 설명합니다. 이 오류는 http 및 net 모듈에서 흔히 나타납니다.
Node.js는 오류 메시지 문자열이 버전마다 바뀔 수 있으므로 오류 종류를 식별할 때 error.code를 사용하도록 안내합니다.
출처
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js는 ECONNRESET을 상대방이 연결을 강제로 닫았음을 나타내는 시스템 오류로 설명합니다., Node.js는 오류 종류 식별에 error.message 대신 error.code 사용을 권장합니다., 이 오류는 http 및 net 모듈에서 흔히 발생한다고 설명합니다. · 확인일: 2026-07-24