오류 메시지

Mac에서 “npm error code ECONNRESET”

ECONNRESET은 연결이 강제로 재설정되었음을 나타냅니다. 재설정한 주체는 알려주지 않습니다. Node.js 문서에서는 “Connection reset by peer”라고 부릅니다.

적용 대상: npm 10 이상은 “npm error”를 출력합니다. 이전 버전은 “npm ERR!”를 출력합니다. 현재 지원되는 모든 macOS 버전.확인일: 2026년 10월 29일

증상

연결을 재설정하는 프록시 또는 필터. 회사 프록시나 보안 소프트웨어가 허용하지 않는 연결을 닫을 수 있습니다.
TLS 검사. 보안 트래픽을 검사하는 프록시가 연결을 방해할 수 있습니다. 회사 프록시 인증서로 Mac의 터미널 도구가 작동하지 않는 경우를 참고하세요.
다시 연결되는 VPN. VPN이 다시 연결되면 VPN을 통한 연결이 끊어집니다.
불안정한 연결. Node.js 문서에 따르면 원격 측의 시간 초과 또는 재부팅이 원인일 수 있습니다.

npm의 레지스트리 및 프록시 설정을 표시합니다.

npm config get registry
npm config get proxy
npm config get https-proxy

레지스트리에 응답을 요청하세요.
```
npm ping
```
curl로 레지스트리를 테스트합니다. 인증서 발급자를 확인하세요.
```
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
```
휴대전화 핫스팟 같은 다른 네트워크에서 설치를 시도하세요.

네트워크에 프록시가 필요하면 npm에 설정하세요.
```
npm config set https-proxy http://proxy.example.com:8080
```
회사 프록시가 TLS를 검사한다면 Node.js용 루트 인증서를 추가하세요. 회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않는 경우를 참고하세요.
npm의 재시도 횟수를 늘립니다.
```
npm config set fetch-retries 5
```
VPN, 프록시 또는 보안 앱이 켜져 있으면 잠시 꺼서 테스트하세요. 테스트 후 다시 켭니다.

Kilobat 연결 진단은 네트워크, 프록시, DNS, 규칙, IPv4, IPv6, TLS 및 서버 순으로 레지스트리를 테스트합니다. 실패한 계층을 알려줍니다.
```
kilobat why https://registry.npmjs.org/
```
이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해 diagnose_connection 및 diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.

ECONNRESET은 프로젝트의 버그인가요?

보통은 아닙니다. 레지스트리 연결이 종료된 것입니다. 다른 네트워크에서 같은 설치를 실행하여 비교하세요.

ECONNRESET은 시간 초과와 같은가요?

아니요. ECONNRESET은 연결 재설정을 보고합니다. 시간 초과는 작업이 제시간에 끝나지 않았음을 나타냅니다.

2026년 10월 29일 확인했습니다.