[VS Code] 확장 설치 시 발생하는 "EAI_AGAIN" 오류 문제

Visual Studio Code(이하 VS Code)를 사용하다 보면, 확장을 설치하거나 업데이트하는 과정에서 다음과 같은 오류를 접하시는 경우가 있습니다.

[error] Error: getaddrinfo EAI_AGAIN mobile.events.data.microsoft.com
    at GetAddrInfoReqWrap.onlookupall [as oncomplete] (node:dns:122:26)

이 오류는 VS Code 자체의 문제라기보다는 DNS 조회 실패로 인해 발생하는 문제입니다. 즉, 특정 도메인(mobile.events.data.microsoft.com)에 대한 네트워크 이름 해석이 제대로 이루어지지 않으면서 확장 설치 과정이 중단되는 것입니다.

---

주요 원인

1. DNS 서버 문제: 인터넷 서비스 제공자(ISP) 또는 내부 네트워크에서 제공하는 DNS 서버가 해당 도메인을 해석하지 못하는 경우가 있습니다.
2. 네트워크 불안정: 일시적인 네트워크 지연이나 끊김으로 인해 DNS 요청이 실패할 수 있습니다.
3. 방화벽·프록시 제한: 회사나 학교망과 같이 보안 정책이 적용된 네트워크에서는 특정 외부 도메인 접근이 제한될 수 있습니다.

---

해결 방법

1. 네트워크 상태 확인

가장 먼저 인터넷 연결이 정상적으로 이루어지고 있는지 확인하시기 바랍니다. 터미널에서 다음 명령어를 실행하여 해당 도메인의 응답을 확인할 수 있습니다.

nslookup mobile.events.data.microsoft.com

정상적인 경우 IP 주소가 출력되며, 그렇지 않다면 DNS 관련 문제일 가능성이 높습니다.

2. DNS 서버 변경

DNS 서버를 신뢰할 수 있는 퍼블릭 DNS로 교체하면 문제가 해결되는 경우가 많습니다.

예를 들어, "/etc/resolv.conf" 파일을 열어 아래와 같이 수정할 수 있습니다.

nameserver 8.8.8.8
nameserver 8.8.4.4
nameserver 1.1.1.1

• Google Public DNS: 8.8.8.8, 8.8.4.4
• Cloudflare DNS: 1.1.1.1, 1.0.0.1

수정 후 네트워크 서비스를 재시작하거나, 간단히 재부팅하여 적용할 수 있습니다.

3. VS Code Proxy 설정 점검

프록시 환경에서 VS Code를 사용 중이라면, "settings.json" 파일에서 프록시 관련 설정을 확인하시기 바랍니다.

"http.proxy": "http://your-proxy-server:port",
"http.proxyStrictSSL": false

프록시가 잘못 지정되어 있거나 SSL 검증이 필요한 경우 오류가 발생할 수 있습니다.

4. 오프라인 설치 활용

네트워크 환경의 제약으로 문제가 지속된다면, Visual Studio Marketplace에서 원하는 확장의 ".vsix" 파일을 직접 다운로드하여 설치할 수 있습니다.

VS Code에서 "확장 → 우측 상단 점 메뉴(⋯) → “Install from VSIX...”" 기능을 통해 오프라인으로 설치할 수 있습니다.

---

맺는말

VS Code 확장 설치 중 발생하는 EAI_AGAIN 오류는 대부분 네트워크 혹은 DNS 설정 문제로 인해 발생합니다. 위에서 소개해 드린 방법대로 DNS 서버를 변경하거나 네트워크 환경을 점검하신다면 대부분의 경우 쉽게 해결하실 수 있습니다.
만약 문제가 지속된다면, 프록시 환경 여부나 방화벽 설정을 확인해 보시고, 필요한 경우 네트워크 관리자에게 문의하시는 것도 좋은 방법입니다.

이 글이 VS Code를 사용하시면서 발생한 오류를 해결하는 데 도움이 되기를 바랍니다.