Apidog Docs
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 요청 오류 수정
  • Back to home
  • 지원 센터
  • Apidog 지원 센터
  • 가져오기/내보내기
    • API 데이터를 Apidog로 가져오는 방법은 무엇입니까?
    • Apidog에서 cURL을 가져오는 방법은 무엇입니까?
    • Postman 환경을 Apidog로 마이그레이션하는 방법
    • Swagger/OpenAPI 가져오기 시 엔드포인트를 자동으로 그룹화하는 방법은 무엇입니까?
  • 요청 보내기
    • Apidog는 Socket.IO를 지원합니까?
    • 매개변수 값의 "+"가 공백으로 디코딩되는 이유는 무엇입니까?
    • Apidog에서 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 GraphQL 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 gRPC 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 SOAP/WebService 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 WebSocket 요청을 보내는 방법은 무엇입니까?
    • Apidog는 WebSocket API에서 사전 요청/테스트 스크립트 및 어서션을 지원합니까?
    • Apidog에서 SSE 요청을 보내는 방법은 무엇입니까?
    • 폴더 수준에서 기본 헤더를 추가하는 방법은 무엇입니까?
    • Apidog는 gRPC API에서 사전 요청/테스트 스크립트와 어서션을 지원합니까?
    • ELANREFUSED.DNS Resolver 오류
    • 요청을 보낼 때 "socket hang up" 오류가 발생하는 이유는 무엇입니까?
    • 요청 오류 수정
      • read ECONNRESET 오류 해결하기
      • ECONNREFUSED 오류 해결
      • ETIMEDOUT 오류 해결
      • ENOTFOUND: Couldn't resolve host 오류 해결
      • ENOTFOUND 해결: getaddrinfo ENOTFOUND www 오류
      • connect EHOSTUNREACH 오류 해결
  • API 설계
    • 경로에서 변수를 어떻게 사용합니까?
    • 응답 컴포넌트를 기본 응답으로 사용할 수 있습니까?
    • 엔드포인트를 수정한 사람을 확인하는 방법은 무엇입니까?
    • Apidog에서 엔드포인트 폴더를 일괄 삭제하려면 어떻게 해야 합니까?
    • 엔드포인트의 경로에 접두사를 일괄 추가/제거하려면 어떻게 해야 합니까?
    • Schema Editor에서 Property의 수준을 이동하는 방법은 무엇입니까?
    • 문자열 속성에 여러 열거형 값이 있고 다양한 위치에서 사용되는 경우, 이 enum을 전체에서 일관되게 참조하려면 어떻게 해야 합니까?
    • Apidog 리소스 폴더 ID를 얻는 방법은 무엇입니까?
    • Apidog의 리소스 폴더 ID는 어떻게 확인합니까?
    • URL 경로에서 변수를 어떻게 사용합니까?
    • 엔드포인트, 문서 또는 테스트 시나리오가 실수로 삭제된 경우 어떻게 해야 합니까?
    • Apidog는 사용자 지정 엔드포인트에 대한 요청 코드를 지원합니까?
    • Swagger/OpenAPI를 Apidog로 가져올 때 엔드포인트를 자동으로 그룹화하는 방법은 무엇입니까?
    • 목 응답에서 중복되지 않는 배열 데이터를 생성하려면 어떻게 해야 합니까?
    • 경로에서 "#" 입력이 지원되지 않는 이유는 무엇입니까?
  • API 디버깅
    • Apidog는 타사 키 관리 시스템과 어떻게 통합됩니까?
    • 동일한 요청이 다른 도구(예: Postman)에서는 정상적으로 작동하지만 Apidog에서는 작동하지 않는 이유는 무엇입니까?
    • Apidog에서 데이터베이스로부터 변수 값을 가져오는 방법은 무엇입니까?
    • 다른 도구에서 Apidog으로 환경을 마이그레이션하는 방법은 무엇입니까?
    • Apidog에서 스크립트를 사용하여 어서션하는 방법은 무엇입니까?
    • JSONPath는 배열만 추출할 수 있습니다. Apidog에서 배열 내부의 단일 요소를 어떻게 추출할 수 있습니까?
    • 서로 다른 환경에서 데이터베이스 계정 자격 증명이 다른 경우 Apidog에서 데이터베이스 작업을 구성하는 방법은 무엇입니까?
    • 사용자 지정 스크립트에서 서비스 기본 URL을 가져오는 방법은 무엇입니까?
    • API 응답이 너무 클 때 Apidog에서 최대 Node.js 문자열 길이 초과 오류가 보고되는 이유는 무엇입니까?
    • 콘솔 출력의 크기 제한은 얼마입니까? 큰 파일을 출력할 때 오류가 발생하는 이유는 무엇입니까?
    • Windows에서 DB2 데이터베이스 연결 오류를 해결하는 방법은 무엇입니까?
    • Apidog에서 Oracle 데이터베이스에 연결할 때 NJS-045 오류가 발생하는 이유는 무엇입니까?
    • Apidog 사용자 지정 스크립트에서 동적 값을 생성하는 방법은 무엇입니까?
    • 동일한 엔드포인트에 대한 클라이언트 요청은 성공하지만, 웹 측에서 디버깅할 때 "주소를 요청할 수 없습니다" 오류가 발생하는 이유는 무엇입니까?
    • 응답이 너무 클 때 Apidog에서 오류가 보고되는 이유는 무엇입니까?
    • Apidog 기록 엔드포인트는 어떻게 사용합니까?
    • 엔드포인트 응답을 정의할 때, 엔드포인트에 응답 콘텐츠가 없어도 됩니까?
    • 사용자 지정 스크립트에서 서비스 baseURL을 어떻게 가져옵니까?
    • Apidog에서 원본 패킷을 보려면 어떻게 해야 합니까?
    • 요청을 보낼 때 "Invalid URI xxx" 오류가 표시되는 이유는 무엇입니까?
    • Apidog 스크립트에서 비동기 요청을 수행하려면 어떻게 해야 합니까?
    • 요청을 보낼 때 "Couldn't resolve host" 메시지가 표시되는 이유는 무엇입니까?
    • 콘솔 출력 크기 제한은 무엇입니까? 큰 파일을 출력할 때 왜 오류가 발생합니까?
    • 엔드포인트 요청에서 파일을 업로드하려면 어떻게 해야 합니까?
    • Apidog가 충돌하거나 응답 데이터가 표시되지 않을 때의 조치 방법
    • OAuth2.0을 위해 Apidog에서 사용하는 공식 리디렉션 URI
  • Mock API 데이터
    • API를 자동으로 목하는 방법은 무엇입니까?
    • Apidog 목 기능으로 무엇을 할 수 있습니까?
    • Apidog에서 고정 API 데이터를 목하는 방법은 무엇입니까?
    • Apidog에서 조건부 데이터를 목하는 방법은 무엇입니까?
    • Apidog에서 클라우드 목을 활성화하는 방법은 무엇입니까?
    • Apidog에서 자체 호스팅 목을 활성화하려면 어떻게 해야 합니까?
    • Apidog는 WebSocket API 목을 지원합니까?
    • 브라우저가 목 엔드포인트를 요청할 때 콘텐츠를 반환하지 않는 이유는 무엇입니까?
  • 자동 테스트
    • 로컬 클라이언트에서는 테스트 시나리오가 문제없이 실행되지만, Apidog CLI 또는 러너에서 실행할 때 오류가 발생하는 이유는 무엇입니까?
    • Apidog에서 테스트 시나리오를 생성하는 방법은 무엇입니까?
    • 테스트 단계 간에 데이터를 전달하는 방법은 무엇입니까?
    • 사전 단계 데이터를 성공적으로 참조할 수 없는 이유는 무엇입니까?
    • Apidog에서 foreach 루프를 사용하는 방법은 무엇입니까?
    • 엔드포인트/엔드포인트 케이스의 데이터 동기화에는 어떤 차이가 있습니까?
    • Apidog에서 테스트 데이터를 사용하는 방법
    • Apidog에서 스크립트로 테스트 데이터를 가져오는 방법은 무엇입니까?
    • Apidog에서 테스트 시나리오를 일괄 실행하는 방법은 무엇입니까?
    • Apidog에서 테스트 작업을 예약하는 방법은 무엇입니까?
    • Apidog에서 성능 테스트를 실행하는 방법은 무엇입니까?
    • 성능 테스트에서 실제 요청과 응답을 어떻게 확인할 수 있습니까?
    • Apidog에서 성능 테스트 보고서를 어떻게 내보낼 수 있습니까?
    • 데이터베이스 쿼리 결과를 반복 API 요청의 매개변수로 사용하는 방법은 무엇입니까?
    • CI/CD 중 ApiDog에서 Stripe 웹훅 캡처 및 검증
    • Runner에서 "Error: unable to verify the first certificate on runner" 오류를 해결하는 방법은 무엇입니까?
    • General Runner Docker 컨테이너 "Not Found" 오류.
    • Apidog 웹 버전에서 General Runner의 서버 호스트를 설정하는 방법은 무엇입니까?
    • 예약된 테스트 시나리오가 0개의 요청으로 종료된 이유는 무엇입니까?
    • Runner 또는 CLI에서 파일 업로드 매개변수를 찾을 수 없는 경우 어떻게 해야 합니까?
    • 업로드 파일 단계가 있는 테스트 시나리오를 Runner로 실행하는 방법은 무엇입니까?
    • Runner에서 "Error: unable to verify the first certificate on runner" 오류를 해결하려면 어떻게 해야 합니까?
    • Runner에 문제가 발생했을 때 문제를 식별하기 위해 Runner 로그에 접근하고 검색하려면 어떻게 해야 합니까?
    • 엔드포인트 매개변수가 업로드 파일이며 Runner 또는 CLI에서 찾을 수 없는 경우 어떻게 해야 합니까?
    • API 사용 사례가 변경될 때 테스트 단계가 자동으로 동기화되지 않는 이유는 무엇입니까?
    • Markdown 문서에서 여러 개의 달러 기호를 사용하면 일부 콘텐츠가 올바르게 표시되지 않는 이유는 무엇입니까?
    • 자체 호스팅 Runner는 작업 실행 후 서버에 테스트 보고서를 생성합니까?
    • 테스트 시나리오의 요청에 통합 사전/사후 프로세서를 추가할 수 있습니까?
    • 단일 자동화 테스트 실행 중 동적 값을 일관되게 유지하려면 어떻게 해야 합니까?
  • API 문서 게시
    • 게시된 문서에서 모든 Apidog 로고를 숨기는 방법은 무엇입니까?
    • API 사양이 업데이트되면 API 문서도 변경됩니까?
    • Apidog에서 협업자에게 API를 공유하는 방법은 무엇입니까?
    • Apidog 문서의 도메인을 사용자 지정하는 방법은 무엇입니까?
    • Apidog에서 다중 버전 문서를 생성하는 방법은 무엇입니까?
    • Apidog에서 Publish Docs Sites의 공유 범위
    • Apidog에서 Share Doc 목록의 공유 범위
    • 게시된 Share Docs에 호스트 이름이 표시되지 않는 이유는 무엇입니까?
    • 공유 문서에서 문서 사용자가 Base URL을 수정하려면 어떻게 해야 합니까?
    • 게시된 Apidog 문서를 복제하여 제 프로젝트에서 사용할 수 있습니까?
    • Apidog 온라인 문서에서 헤더(예: 토큰)를 공유하는 방법은 무엇입니까?
    • 팀원이 게시된 문서를 찾을 수 없는 이유는 무엇입니까?
    • 사용자 지정 도메인에서 SSL 인증서 만료 또는 Cloudflare 526 오류를 어떻게 해결합니까?
    • 사용자 지정 SMTP가 성공적으로 구성되었지만 허용 목록 사용자가 OTP 이메일을 받지 못함
  • Markdown
    • Apidog 내의 다양한 페이지 또는 엔드포인트에 연결하기 위해 카드를 사용하는 방법은 무엇입니까?
    • Markdown 문서에서 여러 개의 $ 기호를 사용할 때 일부 콘텐츠가 올바르게 표시되지 않는 이유는 무엇입니까?
    • Apidog Markdown에서 투명 배경 이미지를 사용하는 방법은 무엇입니까?
    • Markdown 표의 열 너비를 설정하는 방법은 무엇입니까?
    • Markdown 문서에 내부 API, 문서, 데이터 스키마 또는 폴더를 삽입하려면 어떻게 해야 합니까?
    • Apidog 카드 컴포넌트에서 프로젝트 내 문서 또는 엔드포인트에 링크를 추가하려면 어떻게 해야 합니까?
  • 브랜치
    • 스프린트 브랜치에 어떻게 접근합니까?
  • 관리
    • Apidog 클라이언트를 자동 설치하는 방법은 무엇입니까?
    • 관리자 권한이 있음에도 'No Permission' 오류가 표시되는 이유는 무엇입니까?
    • 러너 버전 번호는 어떻게 확인합니까?
    • Apidog는 Windows 7을 지원합니까?
    • Apidog 설치 후 "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" 오류가 표시되는 이유는 무엇입니까?
    • 구독 변경 및 환불
    • 웹 요청은 작동하지만 앱에서 "read ECONNRESET"이 발생하는 이유는 무엇입니까?
    • Windows 시스템 업데이트 후 Apidog을 열 수 없는 이유는 무엇입니까?
    • Windows 시스템 업데이트 후 Apidog가 열리지 않는 이유
  • 청구
    • Apidog에서 팀을 위한 별도의 결제 계정을 설정할 수 있습니까?
    • Apidog에서의 팀 액세스 및 청구 문제
    • 초대된 팀원이 Apidog에 액세스할 수 없습니다.
    • 개인 유료 팀을 조직으로 이전하기
  • 온프레미스
    • Apidog Self-Hosted(Enterprise) 버전의 사용자 및 액세스 관리
  • 웹 및 클라이언트
    • Linux 데스크톱 버전 다운로드 및 설치
  1. 요청 오류 수정

read ECONNRESET 오류 해결하기

ECONNRESET 오류는 Apidog 클라이언트가 대상 서버와의 연결을 성공적으로 설정하고 데이터 전송을 시작한 후, 서버에 의해 연결이 예기치 않게 재설정되었거나 강제로 종료되었음을 나타냅니다.

가능한 원인#

이 오류는 일반적으로 네트워크 연결 문제 또는 구성 오류나 과부하와 같은 서버 측 문제로 인해 발생합니다. 일반적인 원인은 다음과 같습니다.

1. 네트워크 구성 문제#

가장 흔한 원인은 VPN, 프록시 서버 또는 로컬 방화벽의 간섭으로, 연결이 중단되는 경우입니다.

2. 서버 과부하#

서버가 과부하 상태일 때, 특히 배치 작업 중에는 새 연결을 종료할 수 있습니다.

3. 잘못된 요청 구성#

요청 구성(예: 헤더, 본문 또는 URL)이 유효하지 않은 경우, 서버가 이를 거부하고 연결을 선제적으로 종료할 수 있습니다.

해결 방법#

다음 단계를 시도하여 문제를 식별하고 해결할 수 있습니다.

1. 확장 프로그램을 설치하거나 데스크톱 앱 사용하기#

웹 버전을 사용 중인 경우, 요청을 보내기 전에 브라우저 확장 프로그램을 설치하십시오.
또는 데스크톱 앱을 사용할 수 있습니다. 더 나은 안정성을 위해 권장됩니다.

2. 네트워크 및 VPN/프록시 설정 확인하기#

네트워크 문제가 가장 흔한 원인이므로, 먼저 연결 설정을 확인하십시오.
VPN / 프록시:
공개 API의 경우: VPN 또는 프록시 서비스를 일시적으로 비활성화한 후 요청을 다시 보내 보십시오.
내부 API의 경우: VPN이 올바르게 연결되어 있고 대상 서비스에 접근 가능한지 확인하십시오.
Apidog 프록시 설정:
설정 → 네트워크 프록시로 이동하여 Apidog 클라이언트 프록시 구성을 확인하십시오.
환경에 프록시가 필요하지 않은 경우, 유효하지 않은 프록시 설정이 적용되어 있지 않은지 확인하십시오.
이미지.png
방화벽 / 보안 소프트웨어:
로컬 방화벽 또는 바이러스 백신 소프트웨어가 Apidog의 네트워크 연결을 실수로 차단하고 있지 않은지 확인하십시오.

3. 요청 구성 확인하기#

Apidog의 요청 설정이 API 명세와 일치하는지 다시 확인하십시오.
HTTP 메서드:
올바른 메서드(GET, POST, PUT, DELETE 등)를 사용하고 있는지 확인하십시오.
헤더:
모든 필수 헤더(예: Authorization, Content-Type)가 올바르게 구성되어 있으며 오타나 불필요한 공백이 없는지 확인하십시오.
요청 본문 및 쿼리 매개변수:
본문이 JSON 형식인 경우, 유효하고 올바르게 구조화되어 있는지 확인하십시오.
모든 필수 매개변수가 제공되었는지 확인하십시오.
URL 또는 매개변수에 불필요한 공백이나 오타가 있는지 확인하십시오.

4. 서버 과부하 또는 배치 실행 문제 확인하기#

배치 실행 중(예: Apidog에서 여러 테스트 케이스, 테스트 시나리오 또는 예약 작업 실행) 오류가 발생하는 경우:
요청을 개별적으로 보내 보십시오:
“API Management” 섹션에서 실패한 요청을 단일 요청으로 보내십시오.
개별적으로 성공하는 경우:
이는 대량 배치를 처리할 때 서버가 과부하될 수 있음을 나타냅니다. 동시 요청 수를 줄이거나 요청 간격을 늘려 보십시오.
그래도 실패하는 경우:
문제는 네트워크 또는 요청 구성과 관련되어 있을 가능성이 높습니다. 위 단계를 계속 확인하십시오.

5. API 제공자에게 문의하기#

위 해결 방법이 모두 효과가 없는 경우, 서버 측 구성 또는 네트워크 제한으로 인해 문제가 발생했을 수 있습니다.
API 제공자 또는 서버 관리자에게 문의하고, 요청 URL 및 대략적인 요청 시간과 함께 ECONNRESET 오류를 보고하십시오. 이를 통해 서버 로그와 네트워크 구성을 검토하여 근본 원인을 식별하는 데 도움이 됩니다.
Modified at 2026-06-09 08:53:32
Previous
요청을 보낼 때 "socket hang up" 오류가 발생하는 이유는 무엇입니까?
Next
ECONNREFUSED 오류 해결
Built with