ECONNREFUSED 오류는 Apidog 클라이언트가 지정된 IP 주소와 포트의 대상 서버에 연결을 시도했을 때 연결이 거부되었음을 나타냅니다.가능한 원인#
이 오류는 일반적으로 Apidog 자체로 인해 발생하는 것이 아니라 대상 서버, 네트워크 구성 또는 로컬 설정의 문제에서 비롯됩니다. 주요 원인은 다음과 같습니다.1. 대상 서비스가 실행 중이 아님#
연결하려는 API 서비스 또는 애플리케이션이 서버에서 시작되지 않았거나, 요청 시점에 중단되었을 수 있습니다.2. 잘못된 주소 또는 포트#
Apidog 요청 URL에 지정된 IP 주소, 호스트 이름 또는 포트가 잘못되었으며, 서버가 해당 엔드포인트에서 수신 대기하고 있지 않습니다.3. 서버 측 방화벽이 연결을 차단함#
서버의 방화벽 또는 클라우드 보안 그룹이 Apidog 클라이언트로부터의 연결을 차단하도록 구성되어 있습니다. 서버는 연결 시도를 수신하지만 이를 적극적으로 거부합니다.4. 클라이언트 측 방화벽이 연결을 차단함#
로컬 컴퓨 터의 방화벽 또는 보안 소프트웨어가 Apidog 애플리케이션의 아웃바운드 네트워크 연결을 막고 있습니다.5. 프록시 설정 오류#
Apidog에 잘못된 프록시 설정이 구성되어 있어 요청이 대상 서버에 도달하지 못합니다.문제 해결 및 수정 방법#
다음 단계에 따라 문제를 식별하고 해결하십시오.1. 브라우저 확장 프로그램을 설치하거나 데스크톱 앱을 사용하십시오#
2. 대상 서비스 상태를 확인하십시오#
서비스 시작 또는 재시작: 대상 API/서비스가 호스트(서버 또는 로컬 컴퓨터)에서 정상적으로 실행 중인지 확인하십시오.
서비스 로그 확인: 연결을 시도한 시점 전후에 오류 또는 중단이 있었는지 서버 애플리케이션 로그를 검토하십시오.
3. 연결 세부 정보를 검증하십시오#
포트 확인: Apidog 요청 URL의 포트(예: http://127.0.0.1:3000/api/users)가 서비스가 실제로 수신 대기 중인 포트와 일치하는지 확인하십시오.
주소 확인: IP 주소 또는 도메인 이름이 올바른지 확인하십시오. localhost 또는 127.0.0.1을 사용하는 경우, 서비스가 로컬에서 실행 중인지 확인하십시오.
4. 방화벽 및 보안 설정을 점검하십시오#
서버 방화벽 / 보안 그룹: API가 원격으로 호스팅되는 경우, 서버 방화벽 또는 클라우드 보안 그룹이 대상 포트(예: 80, 443, 3000)로의 인바운드 연결을 허용하는지 확인하십시오. 필요한 경우 서버 관리자에게 문의하십시오.
로컬 방화벽 / 바이러스 백신: 로컬 방화벽 또는 보안 소프트웨어를 일시적으로 비활성화하여 문제가 해결되는지 확인하십시오. 해결된다면 보호 기능을 비활성화한 상태로 두지 말고 Apidog을 허용 목록에 추가하십시오.
5. Apidog 프록시 설정을 확인하십시오#
1.
Apidog → Settings → Network Proxy를 여십시오.
2.
대상 서비스에 연결하기 위해 프록시가 필요하지 않은 경우, 프록시가 비활성화되어 있거나 “No proxy”로 설정되어 있는지 확인하십시오.
프록시가 필요한 경우, 프록시 호스트, 포트 및 인증 자격 증명이 올바른지 확인하십시오. Modified at 2026-06-09 08:53:32
